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Preface 


Tht^  DECnvt'RSX  l^o.stinstallation  Chrvhout  Procedures  manual  identities 
|)r()cedures  for  Kt'neratin^  and  installing  a  DKCnet  f^SX  system.  (Therefore, 
you  should  skim  this  manual  prior  to  using  the  DEC^net-RSX  Setirorh  (irrur- 
ation  and  Installation  liuidc)  This  manual  also  defines  procedures  to  he 
ohserved  after  installation.  Hun  these  procedures  to  assure  that: 

•  The  system  is  configured  and  installed  in  accordance  with  defined  proce- 
'vlures. 

•  The  communication*^  hardware  to  he  used  hy  the  DFiCnet  RSX  system  is 
functional. 

•  All  adjacent  nodes  are  reachahle. 

•  The  connection  between  the  local  data  terminal  equipment  (I)TFJ  and  the 
datfi  communications  equipment  (I)('K)  is  operational  for  DKCnet  KSX 
systems  with  a  packet-switching  network  (PSNl  capability. 

intended  Audience 

This  manual  is  intended  tor  users  tamiliar  with  the  operation  of  DKC- 
net llM/S  Version  4.0  and  DKCnet  llM  FIT'S  Version  2.0.  The  user  should 
also  be  trained  in  the  opeiation  of  adjacent  network  nodes.  It  your  DKC- 
net-RSX  system  interfaces  with  a  PSN,  you  should  be  tamiliar  with  the 
operation  of  the  FSN  and  the  X.25  protocol. 

Structure  of  this  Manual 

•  Chapter  1  reviews  DKCnet   RSX  generation  and  installation  procedures. 

•  Chapter  2  describes  a  procedure  tor  checking  your  local  DKCnet  node  and 
remote  nodes. 

•  Chapter  '^  provides  a  list  ot  DKCnet  node  c()nfiguratii)n  guidelines  relating 
to  routing. 

•  Chapter  4  describes  a  procedure  for  checking  your  local  DTE  for  DEC- 
net-RSX  systems  with  a  PSN  capability. 

•  .•\[)pendix  A  describes  loopback  testing  tor  lines/circuits. 

•  .Appendix  H  summarizes  the  DKCnet  test  sender/DKCnet  test  receiver 
(DTS/DTR)  command  svntax. 
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Associated  Documents 

Before  reading  this  manual,  you  should  have  a  working  knowledge  oi  DKCnet 
and  the  RSX  H  operatinjj  s\>  cm  you  are  using.  A  prerequisite  to  the  vWvv- 
tive  use  ol  this  manual  is  tamiliaritv  with  the  overall  character  ol DKCnet  as 
described  in  the  Introduction  to  DEi'mt. 

Programming  and  user  utility  information  (including  X.'if)  and  X.29  program- 
ming tacilities)  concerning  DKCnet  HSX  is  omtained  in  the  following  manu- 
als: 

DFA'nvt-HSX  (iuidc  to  (  'srr  I  'tilitics 
hECnrt  RSX  I'roarcimmrr'.s  licfrrenn'  Manual 
RSX   11  l\^I  r.srr'.s  Cuidr 
RSX  11  I'tilitics  Manual 

Netw«-  .  generation  and  system  generation  are  descril)ed  in  the  following 
three  manuals: 

DhCnrt   RSX  Xrtiinrh  (irmration  and  Installation  (nude 

RSX    llM  System  (icnrration  and  Management  (iuide 

I-iSX   I IMI'LL'S  System  (ieneration  and  Management  (iuid<' 

Information  specific  to  using  the  PSN  capability  of  DKCnet -RSX  for  a  spe- 
cific subscription  service  is  cf)ntained  in  the  RSX -11  I'sj  Xetuorh-Specifie 
Information  manual.  This  manual  discusses  various  public  network  services. 
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SCPXTS  X.2r>  test  sender 

SLD  Satellite  task  loader 

TLK  Terniinai  Communications  utility 

TRI  Trace  interpreter  task 

VNP  X'irtual  network  processor 

XTR  X.2')  lest  receiver 
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[opt-ari^] 


Command  example  verbs  and  keywords 
are  shown  in  a  command  line  in  upper- 
case letters,  and  they  must  be  entered 
as  shown.  Keywords  or  arguments 
within  braces  indicate  that  you  must 
choose  only  one  ot  the  keywords  or  argu- 
ments. (Do  not  include  the  braces  when 
entering  the  command.) 

You  can  abbreviate  any  command  verl) 
or  keyword  to  its  first  three  characters. 
(This  manual,  however,  u.ses  the  com- 
plete verb  and  keyword(s)  in  all  com- 
mand Ibrmats  and  examples.) 

Arguments  are  shown  in  command  lines 
as  lowercase  italic  letters.  (In  this  case, 
you  substitute  the  argument  shown  in 
the  command  format  with  the  precise 
information  requested,) 

The  use  of  ellipsis  means  that  not  all 
the  information  the  system  would  dis- 
play is  shown.  This  information  could 
be  a  system  message,  a  display  in  re- 
sponse to  a  command,  or  user-entered 
information. 

Command  examples  show  all  output 
lines  or  prompting  characters  that  the 
system  displays  in  black  letters. 

This  manual  uses  red  lettering  to  indi- 
cate all  user-entered  commands. 

The  expression  tiK'x  refers  to  a  control 
character  keying  sequence.  The  key  la- 
beled CTRL  and  the  appropriate  char- 
acter key  should  be  pressed  simultane- 
ously. 

A  symbol  with  a  1-  to  .^-character  ab- 
breviation indicates  that  you  press  a 
key  on  the  terminal. 

Square  bracket:-;  indicate  that  the  en- 
closed item  is  optional. 
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Chapter  1 

Installing  a  DECnet-RSX  System 


This  chapter  outhnes  the  stej)s  you  should  have  taken  i)rior  to  runniii^^  the 
l)()stinstalhitioii  checkout  procedures.  Steps  are  ^Touj)ed  accordiii^^  to  >e- 
quence  ol  j)errormaiu'e: 

•  Prior  to  XKTC.KN 

•  Durin.i:  NF;r(;FA' 

•  I'rior  to  network  insiaUalion 

•  During  network  instaUation 

Only  after  you  have  performed  all  the  steps  specified  should  you  use  the 
checkout  procedures  descrihed  in  ('ha|)ters  2  and  1. 

^'ou  should  be  familiar  with  the  information  contained  in  the  following;  docu- 
ments: 

•  DECnrt   RSX  System  Man(i,i>('r\  Cuidr 

•  DHCnct   HSX  Xi'tuorh  (U'm  ration  and  Installation  (iuidc 

•  DKCnvt   HSX  Ri'lrasr  \ntrs 

•  RSX   II  rsi  Rrlcasv  Xotrs  (if  your  DFf'net   RSX  system  interfaces  with  a 
l^icket -switching  Network  (PSNn 


1.1    Steps  Prior  to  NETGEN 


It  vou  have  not  generated  an  HSX  operating  system  tailored  for  DKCnet.  refer 
to  the  DFJ'nct  RSX  Xi'tUDrl;  lu-nvratiim  and  Installation  (Iuidc.  The  follow- 
ing sections  outline  additional  steps  vou  should  have  taken  in  preparati(»n  for 
NKTCKN. 
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1.1.1    User  Requirements 

Before  ^^eneraling  DEC^net   HSX,  make  sure  the  following  conditions  are  satis- 
lied: 

•  The  prerequisite  software  (the  operating  system)  has  heeti  cor/ectly  gener- 
ated and  includes  support  for  networks. 

•  The  (\SH  and  vector  addresses  are  known  to  he  correct  for  all  communica- 
tions hardware  to  he  used  with  DKCnet   HSX. 

•  All  hardware  not  su|)plied  hy  Digital  (for  example,  modems  and  .elephone 
lines)  have  heen  verified  hy  the  supj)lier  to  he  o|)erational. 


1.1.2  Specification  of  Features  During  SYSGEN 

Kecjuirements  regarding  >pecilication  ot  func-tions  and  features  during  S^'S- 
(iKN  fall  into  three  categories: 

•  S^'S(;K^■  requirements  tor  DKCnet   HSX  support 

•  SYSCiFA'  requirements  for  DKCnet   HSX  options  desired  at  NKTCIFA' 

•  Options,   if  desired.   nui>t   he  specified  identicallv  in   hoth  S^'S(;FA■  and 

net(;en 

The  requirements  and  options  are  listed  in  the  DECfut  RSX  Xrtunrf;  (icncr- 
(ition  und  InstaUutum  (iuidr.  The  HSXMC.MAC  file  is  an  out|)ut  of  S^■S- 
(iF.N.  This  file  contains  definitions  of  the  symhols  that  identify  the  options 
selected  at  SYS(;EN.  Always  check  the  HSX.MC.MAC  file  to  verifv  that  all 
required  symhols  are  defined.  The  file  can  he  checked  hy  listing  it  on  a  hard- 
copy  device  or  hy  displaying  it  on  a  terminal.  If  the  recjuired  symhols  are  not 
defined,  the  HSX  operating  system  must  he  regenerated. 

1.1.3  Patches 

Collect  all  patches  that  apply  to  your  kit.  Then,  accorrling  to  the  instruct  ions, 
apply  the  patches  to  a  copy  of  the  kit.  Hefer  to  the  current  DEi'urt  RSX 
Hclvusc  \<itvs  and  RSX -11  PSl  Rrlrasc  Xotrs  hefore  applying  the  patih. 


1.2    Steps  During  NETGEN 


Execute  \ET(;FA'  (preferahly  fn»m  a  hard-copy  terminal)  acinrding  to  the 
procedures  descrihed  in  the  DECnrt-RSX  Xctimrh  (icncmtion  and  in>t(illn- 
tion  (iuidc.  When  the  procedure  has  run  to  completion,  review  the  output  for 
errors.  If  there  are  any  errors,  correct  them  hefore  procee(hng.  When  you  have 
huilt  a  system  you  helieve  will  run,  proceed  to    Section  l.li. 
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1.3    Steps  Prior  to  Network  Installation 

To  verity  that  you  specilied  DKCnet  HSX  system  information  correctly  dur- 
ing the  NF/rdKX  process,  use  one  ot  the  loliowin;,'  procedures; 

•  Kxamine  the  network  component  parameters  using  the  ("ontiguration  Kile 
Kdiior  (CFKl 

•  List  and  examine  NF/rCFIvCMI)  and  NF/rCFC.  TX  T.  both  located  under 
the  network  I'lC  i.v.v.v.l] 

These  techniques  are  described  in  the  following  sections. 

1.3.1  Use  of  the  Configuration  File  Editor  (CFE) 

CFF  can  be  used  to  examine  the  data  for  the  network  configuration.  (Kor  more 
information  on  CFK.  refer  to  the  DECtut  HSX  S\sirm  M(in(iiirr\  (iui(h\\ 
I'se  the  following  CFF  commands  to  determine  how  tlie  c(»mp<»nenl  parame- 
ters were  set  during  XFTdFX: 

LIST  SVSTFM 

LLST  FXFCITOR 

LIST  KXOWX  LIXKS 

LIST  Kxowx  CIRC  rirs 

LIST  KXOWX  L()(i(iIX(; 

LLST  KXOWX  XODFS 

LLS1'  KXOWX  OH.IFCrs 

The  following  (T'K  commands  are  useful  onl>  in  DFCnet  KSX  networks  that 
interface  with  a  packet -switching  network  by  mean.^  of  the  Packet  net  System 
Interface  \  PSIi  product: 

LIST  MODILK  X2.VA('(T:sS 

LIST  MODILK  X2.Vl'KorO("OL 

LIST  MODILF  XJ.VSKHVFR 

LIST  MODILK  X29-SKRVFR 

1.3.2  Examination  of  NETCFE.CMD  and  NETCFG.TXT 

The  XFTCFK.CMI)  tile  is  a  journal  of  all  the  (ommands  entered  and  exe- 
cuted during  XKTdFX.  This  file  also  lists  the  CFF.  commands  executed  in 
the  selection  of  any  of  the  default  values  implicitly  or  ex|)licitly  specified 
during  XH'rciFX. 
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I  he  \K  I  (  K  i   r\  r  iilv  contains  a  tiarrat  i\c  dc-c  rijjtioii  <.|  the  >\>,i(.jn  (oiili^ 
uration  as  tornu-d  during  NK'ICKN. 

Both  liles  are  a  prodncf  cf  ncfwr.rk  izcncraticn.  Thcv  .KdiraicK  nih,  t  td,. 
(•..nfiKiirafi..n  ..(  the  tuMuork  at  NKTCKN  In  ,,.,  the  lil(.>-  inl..rrnaiiM„.  ||.i 
one  or  Ix.th  ..n  a  hard  (<.|.\  dcvK c  and  vrnlx  th;,i  the  r(-ult>  ..{  the  tu  iwntk 
UcncratK.ii  rcllc(  t  tlicnptinn^  that  von  intended  t..  -pei  il\ 

14    Steps  During  Network  Installation 

Once  the  netw(.rk   paranieter>  have   been   \erilied.   the  -ctlware  (an   he   in 
stalled,    Reler    t.,    the    DKinrt    HS\    \,(nnrh    (.mrnitmn    and    In^tnilntmn 
(iuidr  and   the  DI'J  n.f    RS.\   S.^tmi    .\Jan(,u,r\    (iuul,    |.,r  guideline,  and 
instruction-  tor  hrin^iint:  \\\)  \niir  DKCnet    RS\  ^v-teni 

After  the  node  i>  uj)  on  the  target  >\>lein.  it>  operation  should  he  Nenlied  a^ 
t(tllo\s>; 

•  II    the  >\Mern    inc  hide-   DKCnef    >iipport    oser   Kthernet.    leaxd.   oi    private 
lme->.  tojlou   the  pro( cfhire-  de-(  riherj  m  Chapter  1 

•  II   the  system   includes  t}ie  (apahilit\    t(.  interface  with  a   I'SN.   test    that 
capability  by  following' the  procedures  descrihed  in  Sect K.tis  l.lthrounh  l.i. 

•  If  fhesvMeni  uu  lude>  hKCnet  >upp..rt  oser  I'.sN  lac  ilit  ie>  (data  l.nk  map 
pinut.  follow  the  procedures  given  in  Ch.jpter   \  te.  check  the  oper.itio,,  nf 
I  )LM  ( ir(  uits. 
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Chapter  2 
Installation  Testing 


This  i-ha|)t('r  dt'scrilics  j)nHe(iur('s  you  i-an  use  to  clu'ck  your  HSX  US. 
HSX  1 IM.  or  RSX  1 IM  PLl'S  uodc.  Certain  rest ritt ions,  as  outlined  in  Sec- 
tion 2. }.  apply  to  testin*,^  an  I^SX  1  IS  node.  The  checkout  procedures  consist 
ol  three  types  ol  tests: 

•  The  first  test  verities  that  your  local  node  software  is  operational. 

•  The  second  test  verities  that  voin-  local  DKCnet  !iode  and  communications 
hardware  are  functioning^  propcrlv. 

•  The  third  test  checks  your  local  node's  ability  to  communicate  with  a  re- 
mote node  (see  Figure  2   \). 

All  procedures  are  desi^Mied  to  he  uiitiated  and  executed  from  the  N.ial  node. 
However,  an  operator  should  he  available  at  each  remote  tiode  to  assist  in 
problem  isolation.  To  facilitate  problem  isolation  tor  reinote  loopback  testing, 
you  should  enable  the  event  logger  il  you  have  not  done  so  alreadv  or  if  event 
logging  has  been  turned  oft  witli  CKK  or  \iV.  i If  event  logging  was  selected 
as  an  option,  the  default  state  is  ON  as  a  result  of  NF/l'CKX.i  Nou  can  enable 
event  logging  by  using  the  following  command: 

NCP:SET  LOGGING  CONSOLE  STATE  ON 

For  more  information  <»n  the  Network  Control  Program  (NCPi  commands 
mentioned  in  this  chapter,  refer  to  the  UFAmt  HSX  Sx^trm  M(inuinr\ 
(iuidr. 


2.1    Local  Node  Software  Testing 

This  test  verifies  that  five  layers  of  soUuare  are  working:  the  I  ser  laver.  the 
Network  Management  la\«*r.  the  Network  Application  layer,  the  Knd  Com- 
munications laver.  and  part  of  the  Routing  layer.  'I'his  test  d(»es  not  «  heck  the 
device  driver  or  the  communicat ion>  device.  See  Figure  L'  2  for  the  path  the 
test  data  travels. 
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Figure  2-1:    Installation  Test  Flowchart 
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Figure  2-2:    Local  Node  Software  Test 
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You  may  use  other  types  of  tests,  hut  the  NTKST.C'MI)  procedure  is  preferred 
hecause  it  is  automated.  The  XTKST.rMI)  procedure  tests  and  installs  the 
network  tasks  needed  lor  testing  and  hrin^s  up  the  network. 

If  the  requirements  of  Section  2.1.1  cannot  he  met  (tor  example,  a  UiK-word 
system  controlled  partition),  the  'I'LK  and  LSN  utilities  can  he  substituted 
for  the  \TKST.('MI)  test. 

NTKS'r.('MI)  executes  two  sets  of  programs:  DKCnet  test  .sender  (I)'1\S)  and 
DKCnet  test  receiver  (DTK),  and  Network  File  Transfer  (\FT)  and  File 
Access  Listener  (FAL).  D'l'S/D'rH  pertorm  messa^'e  transfer  operaticms  using 
task-to-task  communication.  NF'IVFAL  perform  various  file  transfer  opera- 
tions. Details  of  the  DTS  DTK  programs  are  in  Appendix  B.  Details  of  NFT 
and  FAL  are  found  in  the  DECnrt  HSX  (iuidv  to  ( 'scr  I'tHitirs. 

2.1.1  Preparing  to  Run  the  Test 

The  following  conditions  must  he  met  helore  the  local  .\"!'KST.('MD  proce- 
dure is  executed: 

•  The  partition  in  which  the  network  software  and  the  software  tools  will  run 
must  he  system  controlled  and  at  least  HiK  words  in  length. 

•  A  NFlTdKN  must  be  completed. 

•  NF/I'dKN  must  have  moved  the  XTKST.CMD  file  onto  your  disk  under  the 
riC  I.VV.V.24;.  where  v.v.v  is  the  group  code  chosen  during  NKTdFA'. 

•  Vf)u   must    be  logged  into  a  privileged  account   (if  your  .system  supports 
multiuser  protection). 

When  you  have  satisfied  the  conditions  listed  above.  pn»ceed  to  the  next 
section  and  run  NTKST.CMD. 

2.1.2  Running  the  Test 

First,  set  the  network  TIC  number  under  which  you  stored  NTKST.CMD. 
You  can  set  this  number  using  the  following  command: 

SET     /UIC  =  [.v.vr  .2^]     W 

where  v.v.v  is  t  lie  network  software  llC  group  code  specified  during  NKTdKN. 
Next,  invoke  the  coFnmand  tile  l)y  entering  the  l(»llovving: 

> eNTES7.CMD    Wl 

NlKSr.CMD  begins  to  execute  and  prompts  you  for  any  input  it  requires 
during  execution.  Figure  2  :\  is  a  .sample  listing  of  the  NTKST.CMD  proce- 
dure. 

NOTE 

Your  mswers  to  the  questions  displayed  hv  the  N'lTlS'I'  ("Ml) 
procedure  may  be  different  from  those  shown  in  the  sample 
listing.  For  example,  you  may  specifv  device  names.  YKS  and 
NO  opt  ions,  and  group  lIC  ((,des  that  differ  from  those  shown. 
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>SET  /BUF=TI:80 


rvSK- 1  IM.'M-PLUS  Network  Installation  Procedures 


Cop-risht  'C^  1S"^9.  198<:'.  1981.  198Z.  1983  bv 
Digital  E q  Li  1  p (t> e  ri  I  C  o  r  p  o  r  a  t  i  o  ii  »  h  a  ■  '■.  a  r  ■  j  •  Mass. 

; 

SET   UIC-C  1  .  1  ] 

Te?t.     p  r  0 ':  e -J I  r  e    performe'i     at     i''8:i.'Z:34    on    <;il-AUG    8  3 

This     p  r  0  c  e  'J I '  r  e     is     d  e  s  i  g  ii  e  'J     to     a  1  1  o  '.>    a     >  •  5  e  r     to    f  e  r  f  0  r  ni    the     f  0  1  I  0  m  i  n  3 
tests     oriaDEC  1-1  et-llMMPLUSssteifi: 

I  ii  t  e  r  1 1  a  1     node     1  e  "  e  1      -  -     Test     the     local     ii  0  d  e    1.1 1  t  h  0  m  I     u  s  1  n  s    a  11  . 

c  0 m m Mri  1  c  a  t  1  0  n     circuits. 

C  1  r  c  u     t  s     1  e  "  p  1     -  -     Test     the     local     > .  0  .j  e    i.m  t  h    a     c  0  tn  m  1 1  rt  1  c  a  t  1  0  n  ^     1  1  r,  e 

a  t  t  a «.     e  d    to     a    t  u  r  n  a  r  0  1 1  n  d     I  0  0  p  t  a  c  J     i-j  p  ■  ■  1  r  e    or     a    ni  0  d  e  nt    1.1 1  t  h     1  0  0  p  h  a  c  > 

capabilities. 

Remote  node  le-el   --  Test  t  "n  e  local  node  b-  attemFtiMg  to  con.inMni 

c  a  t  e  w  1  1 1^  a  remote  i"i  0  d  e  . 


The     procedure    !.■  1  1  1     PKecte    DTbDTR     tests    and    u-ill     nse    NFT    FAL     to 

t  r  a  1,  s  f  e  r     a  n  d    e  «  e  c  1.1 1  e     f  1  1  e  s  . 

Before  r  m  i,  n  1  n  s  t  h  1  i  p  r  0  c  e  J  '■  r  e  .  .on  should  h  a  "  e  access  t  u     the  folio  ui  1  m  g 
1 11  f  0  r  m  a  t  I  0  n  : 


The  de-'ice  and  sro-ip  code  of  the  UIC  under  which  the  netMorK 

tasKs  are  stored. 

The  tarset  node  name  (for  local  tests,  this  is  the  local  node 

ri  a  (ti  e  )  . 

The  i  i  e  c  e  s  s  a  r   UIC  and  p  a  s  s  '•■  0  r  d  to  a  c  c  e  -^  s  file-,  residing  0  .  >  the 

target  n  0  .1  e  .  for  N  F  T  tests. 

Do  you  u' a ri  t  to:   C R  -  c  0  ri  t  1  ii  n  e  E  -  e  h  i  t  P  -  p  a u  s  e  153: 


Test  Par  ame t e  r  s 


If   ■  0  ".I  d  0  ri  0  I  choose  Ions  d  1  a  I  0  S  u  e  mi  0  d  e  •  e  w  p  1  a  n  a  t  0  r  -  tent  for  e  a  f  h 
question  15  a"ailable  b,  hittins  the  "ESCAPE"  Ke.. 


Do  V  0  1 1  1.1  a  n  t  long  dialogue  m  0  d  e  "^  [  V  /  N  ]  : 


>; 


5  E  r.  t  e  r  the  UIC  3  r  o  u  p  code  u  v,  .j  e  r  which  the  1 1  e  t  ui  c  1 1  file,  ui  e  r  e  stored 
♦  f  0  r  t  h  1  s  ii  n  d  e  '  s  ii  e  t  w 0  r  >.  . 


y  I 


-  What  3  -  -^  o  p  UIC  IS  the  network'  stored  h  . ,  d  e  r  TO  R  :  1  3  7  7  ]  :  1  > .  < 


Specif,  the  de'ice  on  which  the  net  wort  files  are  stored.  The  def-iult 

d  e  '  1  c  e  1  s  "  5  V  !  "  . 


; 


On    ...hat     de"ice    are     the     i.etworK     files     (QDNN)     [S    R:'i-5]:     OH  I  : 
:A5N    DMl : =5V: 

'■* 

I  Answer  "YES"  to  the  newt  «»uestion  if  this  is  an  internal  node  tP-t  , 
•  J  I.e.  the  test  does  not  1  n » ■  0  1 ' ■  e  c  0 m m u  1,  i  c  a  1 1  0  ti  s  1  i  r. »  <;  and  0  r 

I  r  e »»» 0  I  e  n  0  d  e  s  . 

; 

■  Is  this  an  1  r.  le  r  n  a  1  node  t  e  s  t  "^  C  V  /  N  ]  :   . 

imut iiuifd  on  iitxf  |).ni«i 

Figure  2-3:    NTEST.CMD  Sample  Listing 
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I  Enter  the  tar  set  n  o  ^J  e  Mdme  (1-G  .-^  i  p  an  ume  r  i  i  c  h  o  r  ac  t  e  r  %  '  .  Thi-  is  the 
>J  r,o-Je  ipame  of  the  remote  ncje.  If  •  r  i  5  is  an  internal  le-el  test,  then 
^  '  the  local  r-i  0  d  e  r.  a  m  e  5  h  0  m  1  .j  be  m  5  e  .j  .  If  i  h  1  >;  1  ^  a     1  1  ,,  *?  1  e  -  e  I  r  ^  ^  t  .  then 

'  the  1  0  0  p  b  a  c  *  n  0  -j  e  ><  a m  e  %  h  0  <.•  1  J  t  e  <  1  $  e  d  . 
■  V 

What     15     the     local    n  0  ^j  e    .  ^ „.  p     [  s    R  :  i  -  G  )  :     m^ode  A  ■ 

5    D  T  5    '.'  1  1  1     n  0 '.'    t'  e     1 1 1 "  0  r  e  •]    to    Perform    three     t  e  5  1 1  : 

t  l.»       DT5    w  1  1  1     1  s  s 'ip    a    c  onnec  t     r  e«i"e?  ♦     t  n    DTR    c  an  s  I  r.  3 

'  0  T  R    t  0    b  e     1  0  a  d  e  'j  '    a  1 1  9  >.'  e  r     t  h  e     r  e  "^  n  e  ';  t     a  n  cl    t  a  =  > 

!  e  V  1  t 

'  2  .  »       D  T  5  /  D  T  R    will     e  k  e  c  '.'  t  e     a     1     minute    patter,,     t  e  .-  t 

'  MsiiiS    a     10    b    te    tnes^ase     si;e 

•  3  .  »       D  T  S  '  D  T  R    will     e  X  e  c  ','  t  e    a     1    mi  r<<<  i  9    patter  1 .    t  e  i  t 

'  1.1 3  I  n  9    a  Ti     i  1  <;n;i    t, .  t  e    in  e  %  s  a  9  e     ?  1  r  e  . 

• 
• 

;  The  1  •  t  t'  ■  t  e  'Ti  e  s  s  0  9  p  <?  1  :  e  '.-as  selected  t.  e  c  a  m  s  e  this  -,  1  ;  e  1  =,  smaller 

'  'han  ECL  ■  5  sesment  5  1  :  e  .  .  .  t  h  ..• -:  there  uill  te  1  ^edinent  for  each 

5  x.essase.  The  1100  bvte  messase  ?i:e  is  laraer  thai,  the  ie^inei.t  si^e' 

'  therefore,  there  will  t.  e  w  »  1  t  1  s  e  9  .n  e  n  t  s  for  each  of  t  h  e/^  e  .«  e  ^.  ?■  a  s  e  s  . 

f'EM  .  .  .DT5 
REM  DTR. . . 

INS    DMl:Cl'iM,S4|DT5     INC^G'V' 
INS    DM1  : [ 10"  .5a]DTR  ■  INC=50n 

PIP  dt5tst.cmd;  de  nm 

DT5  9DTSTST 

LOADE  -EC  DTR  OIA  CONNECT  TEST 
DT5  '-  Test  finished  at  9:t;'3!3<' 

FAT  MSG=10/TIMEMM 
0  T  5  -  -  T  e  s  t  s  t  a  r  t  e  d  a  t  B  :  'J  3  :  3  0 
DTS   -  Test  finished  at  8:-'fl:3" 
3 "13  Messages  se  n  t 

5 ' » 2  C  h  a  r  a  c  t  e  r  5  -i  e  c  0  n  d 
^*'1G  Ba'id 

FAT    M5G=  I  100'  TIME---  IM 
DTS    --    ■''est     started    at    8:0a:3l 
DTS    --    Test    finished    at     8:'"'?ijl 
8''SMes5aies5ei-it 

16«:'S0  Characters -'second 
128480  Baud 

PIP  DT5TST.CMD5/DE  NM 


In  or 
a  c  c  e  s 
1  ri  f  0  r 


I 

What  1 

What  1 

PIP  NFT 

« 

!  NFT  w 

'  t  r  an  4 

•  a  c  c  e  5 

5  M  ie. 


der  to  e«eciite  NFT  file  transfer  'est^.  .on  >f^>>^\     -,  uppi   -alid 
s  control  intormation  fo.-  the  target  nodt  NUDE  A.  This 
w  a  I  I  0  r.  I  5 

'■  1  )  ,  A  u  5  »  r  I  d  » i  •  t  1  f  1  c  a  t  I  0  n  'the  f  0  r  >!<  a  t  d  e  ^  e  ri  d  s  0 »  •.'  h  .3  r.  ♦.  p  »   f 
s , stem  NODE A  15. 

'2'.  The  Password  for  that  '.iser-id. 

5  X^9     user -Id  for  NFT  tests  on  r^ode  NODE  A  CS  Rjl.  iG.l: 

s  the  corresponding  password  tS  Rrt.-B.ls  • '^  : 
TSl  . 22:  5  DE /NM  .NFTTS2 !  .NFTTRT J  .NP TTSa  5  .NFTTS5  ; 

111  now  be  innofed.  A  co*.  of  the  command  file  NTEST.cmd  will  be 
ferred  to  node  NODEA  with  the  filename  TMPNET  TSt  .  222  -si-!*  th* 
5  control  information   ou  specified.  NFT  will  then  delete  the 
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NFT  0NFTT51 . ZZZ/TR 
NFT  NODEA'CZOO  »200  3  /PfVIV;  :  T  MPNE  T  TST  .  ZZ:  J  1  =D(^1  :  C  100  .ZUlNTEST.CMD 


The  file  TMPNETT5T  .ZZZ  will  now  t- e  1  e  1  e  t  e  ■  1  u  s  i  r.  «  NFT. 


NFT  9NFTT5:.ZZZ' Try 
NFT  NODEA/ tZOO  fZOOJ/PrylV:  :  TMPMETTST  .ZZZ  5  J /DF 

PIP  NF  TTBl  . ZZZ  ;  DE  NM  .NFTTSZ ;  fNFTT53;  .NFTTS4;  .NFTTS?  5 
ASN« 


If    >'  0  M  h  a  "  e  r  e  a  c  ^  e  J  this  p  o  i  n  t  with  r.  o  errors"  t  h  #  n 
c  0  n  f  id  f  11 1  that  the  t .  o  -j  f  has  t>99y<    c  r  e  a  t  e  •  j  p  r  o  "  e  r  1  /  . 

Erirj  cf  te5t  at  08;  07.12 


V  0  tj  c  a  ri  t>  0 


;  s  X  s  :  ^  :  r  r  ::  ^  :  r  = 

SET  /UlC't 100 -za] 
»   EOF 


E  ri  (j  0  f  I  r.  5  t  a  1  1  a  t  1  0  r.  Test 


s'sssssassrs 


szszszrsssz;;: 


Figure  2-3  (cont.):    NTEST.CMD  Sample  Listing 

Now.  list'  \hi'  \("l'  >Hn\\  KXKcnOH  COl  \  IKRS  iuid  SHOW  SNS'IKM 
(OlNTKHS  ( ..rnrijarui>  t<>  (iis|)iin  flu-  (■••iint('r>.  (lu-ck  the  (•(>uiitcr>  tor  rr 
n>rs,  it  thtrc  are  aii\  errors.  |)ro(  ccd  to  Section  _',!.;{. 

it  ItuTf  are  no  vJi.t-.  proceed  to  >e(tion  J  J.  Nodf  Level  (■orniniinieatioi)> 
(irciiM    le^tipy.  u-mi.'  «>  hardware  loophaik  desne. 

Thi  tnj.^twin^'  cnuiiter^  reflect  an  error-tree  te>t  execution  I'pon  entr\  ot  the 
NCPSHOW  KXKCI  I"OR  (Ol  N'l  Kl^s  K.rnniand.  the  tollowin^' i>  di>plaved 
at  vour  terminal: 


Node    conr,  ters    a%    of    01 -MAR- 83    09:Za:l2 


E  -<  e  c    t  0  r    node 


1 009 182 
1009182 


\a     'NODEA) 


308       5  »  c  0  f'  d  5    since     last     r  e  i  o  e  1 


Bvtes    r»c»i"»d 
Btes    s»rii 


17G?8  Mes^aies     received 

17B?8  Messaiesse^t 

8  Con n e c  i "    r  e c  e  1 '' ed 

8  C  0  roi »  c  1 5    5  e  n  t 

0  T'osPQusw    I  I  m  e  0  u  I  » 

0  F<ec»i"ed    connect     r*«o>jrct    trror* 

2  Total    m  a  X  1  m  1.1  w    1  o  «  i  c  «•  i     lints    a  c  1 1  "  e 

0  A  s  e  d    p  a  c  >:  •  t     1  0  5  % 


N  0  d  t    ».i  r.  r  t  a  c  h  a  t'  1  •    p  a  c  ►;  e  i     1  o  «  » 
Nodt    O'ji-of-rar.ie    packet    \  o%% 


0 

0      0"fr5i2«d    Packet    less 

ft         P  X  r  r  #  t      *  n  T  m  ^         ••  t   f  "  i  i 


0      V  e  r  I  f  1  c  a  t  I  c  n    r  »  .J  •  c  t 

2      Node    m  a  I*  I  m  M  m    1  0  «  1  c  a  1     1  i  ri  >;  s    a  c  t  i  "  e 

0      Total     recti  "td    conritct    reso'.ifce    errors 
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To  display  the  system  counters,  enter 

NCP  SHOW  SYSTEM  COUNTEfyS 

The  tbllovving  is  displayed  at  your  terminal: 

S  V  5  t  e  (ti  c  0  M  ri  t  p  r  5  as  of  (^i  1  -  M  A  R  -  8  3  09:25:03 

3S8  Secoriijs  sirice  last  reroed 

()  C  0  1-1 1  r  0  1  b  1 1  f  f  e  r  a  1  1  o  c  a  I  i  o  ri  failed 

0  S  (II  a  1  1  buffer  a  1  1  o  c  a  t  i  o  r,  failed 

0  Large  buffer  allocation  failed 

0  rv  e  c  e  1  "  e  buffer  a  1  1  o  c  a  l  i  o  ri  failed 


2.1.3    NTEST.CMD  Failure  Conditions  and  Handling 

The  most  common  failure  conditions  encountered  during  this  test  are  resource 
allocation  failures  or  network  tasks  not  installed.  The  symptoms  most  com- 
monly seen  under  these  failure  conditions  are  described  below.  Identity  which 
cla.ss  of  failure  is  occurring,  take  apj)ropriate  corrective  action,  and  then  re- 
peat the  test. 

Common  symptoms  of  this  class  of  failure  are; 

•  Inability  to  execute  the  \CV  SKT  SVSTKM  command 

•  Inability  to  execute  the  NCP  SFIT  HXKCTTOH  STA  TK  ON  command 

•  Inability  to  establish  a  logical  link 

Corrective  action.  If.  at  anv  time,  the  operation  appears  to  be  hung  use  the 
\(T>  SHOW  .SVSTKM  ('()rNTKH<  command.  If  any  of  the  counters  are 
incrementing,  there  is  a  resource  all  it  ion  problem.  The  network  should  be 
unloaded,  and  the  resource  allocations  should  be  increased  using  CFK.  Once 
the  system  resources  have  been  increased,  reload  the  network  with  the  \(\* 
SKT  SVSTKM  command.  Then  set  the  executor  stale  OX  with  the  \CV  SKT 
KXK(TTOK  STATK  ON  command. 

Allocation  failures.  Resource  allocation  failures  include  one  or  more  of  the 
following  conditions: 

•  Insufficient  numl)er  of  large  buffer^  (LI)H>) 

•  Insufficient  number  of  control  buffers  (CCHs) 

•  Insufficient  number  of  small  buffers  (SI)Hs) 

•  Insufficient  HSX  system  pool  size  (I)SHl 

•  Insufficient  number  of  logical  links 


• 
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Other  failures.  Other  reasons  for  tailure  lan  include  one  or  more  ot  the 
tollowing  conditions: 

•  Insulficient  checkpoint  space 

•  Fragmented  system-controlled  partition 

•  Hardware  prohlems.  including  disk  errors  that  :an  result  in  nonreproducihle 
system  hehavior 

It  there  is  insutlicient  checkpoint  space.  KCIM  (routing  control  j;rocess)  ma\ 
not  he  ahle  to  allocate  space  tor  its  data  hase  and  you  would  receise  the 
following  message: 

R  C  P  I  C  a  n  ii  0  t     allocate     space     for     'j  a  t  a    t^  a  s  e 


For  more  information  on  network  load  failures,  refer  i<t  the  l)H(  fn  (  RSX 
Si'tHorh  (icnrratian  and  InstaUutun]  (iuidv. 

If  NTKS'r.CMI)  fails  while  running  DTS DTK  or  NFT  FAL.  refer  to  .Appen- 
dix H  (for  DTS  DTK)  or  to  the  DKCiirt  RSX  (imdi'  (o  I  srr  Cdlitics  (for 
NFTF.AIJ. 


2.2    Node  Level  Hardware  Loopback  Circuit  Testing 

This  test  verifies  that  th?  Routing  layer,  the  device  drivers,  and  the  communi- 
cations hardware  are  functioning  properly.  In  addition  to  the  layers  tested  in 
the  local  node  software  tests  (Section  2.1).  the  Data  Link  and  Physical  Link 
layers  and  associated  hardware  are  tested  in  this  procedure. 

This  test  transfers  data  over  the  commimicalions  circuit  through  the  loopback 
connector  to  the  as.sociated  loop  node  name.  Figure  2  \  shows  the  path  the 
test  data  travels.  As  illustrated  in  Figures  2  ()  and  2  7.  the  test  can  he  run  to 
the  controller,  to  the  local  modem,  and  to  the  remote  modem. 

Observe  these  specific  instructions  for  the  type  of  device  you  are  testing. 

•  For  LNA  and  QN'A  devices.  j)r()ceed  to  Section  2.3. 

•  For  FCL.  PCL-  N.O  is  assigned  as  the  local  TDM  address.  This  circuit  should 
be  used  tor  the  tests  specified  in  this  section. 

•  For  DLM,  run  the  I^SI  checkout  procedures  first,  including  NCP  LOOP 
LINK;  then  proceed  '■>  Section  2.'\. 

•  For  multipoint  devices  (controller  or  tributary)  using  software  DDCMP. 
proceed  to  Section  2.'.]. 

•  For  half  duplex  devices  (point  to  point )  temporarily  set  up  to  full  duplex  lor 
the  hardware  local  modem  loopback  test,  if  successful,  switch  back  to  half 
duplex  and  proceed  to  Section  2..'l 

•  For  all  other  devices,  proceed  to  Section  2.2.1. 
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Figure  2-4:    Node  Level  Test  Using  a  Loopback  Connector 
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2.2.1    Preparing  to  Run  the  Test 

Perlnrni  three  steps  belore  runiiiim  the  test: 
Step1: 

•  InsiMll  \hv  hardware  loopbaek  (-(Hinectdr  usin^'  the  cotinector  Hsted  \n  Table 
A   1 

•  Ise  the  analog  loopback  button  (Ui  the  mi>(leni  (see  Section  A.I.I) 

•  Set  the  device  (DMC  DMH.  DMP.  or  I)M\'»  to  controller  loopback  with  the 
lollowin^'  NCI'  commands: 

NCP  '^ET  LINE  Dli:-n 

NCP:  5ET  LINE  DMC-O  CON   OLLER  LOOPBACK 


Step  2: 

I'se  the  lollowint;  NCP  commancU  to  >et   the  line  and  ciri  iiit  on  (asMiming 
that  the  line  i.'^  not  alieady  loaded*,  Kor  .xample,  enter 

NCP  -^ET^INE  DMC--  DUPLE   FULL 
NCP  -.E  T  CIPCUn  DnC':'  5TATF.  ON 


The  e\ent    loi,'^er  prints  a  messa^'e  on  tlie  console  it  loj^^in^'  is  etifibled.   A 
sample  mes>a|4e  is  >Iio\mi  below. 

E  '  e  ri  t     t,    p  e    <^  .  1 '"'  •    C  I  r  c  '.1 1 1    '.!  p 

Occurre'3    mI-MAP-SD    09:Z9:17    on    no-je     \a    'NODEA» 

C  I  r  c  u  1  ♦     DMC -  0 

No'jf    a^l.Jress     =     lU     iNODEh) 


Step  3: 

I'se  the  NCP  SHOW  tonnnand  to  verilv  that  the  circuit  state  has  chanKcd  to 
ON.  Note  that  the  executor  node  is  now  also  the  adjacent  node  on  the  lest 
circuit. 

NCP     :hOw    C  Ii^Ciji  T    DIG  -''> 


A  sam[)le  of'  the  .•*uiiimar\  displayed  is  shown  below: 

Circuit    S'.immar'    as    r>f    u  i  .fi^^iV- 83    '>St^r:?G 

CircMit     =    DnC-0 

5 1  a  t  f    =    0  n 

A.jjactr,  I     r,0'j#     =     I  a     (NODE  A) 

It  the  >*tate  on  the  circuit  is  still  on-starting',  proceed  to  Section  2.2..')  (On- 
Starting  Substate  Krror  Handling,' ). 
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2.2.2    Running  the  Loop  Node  Test 

\  sv  the  SKT  NODK  if.nini.uH!  with  the  CIHCriT  panuiictcr  to  establish  a 
loop  node  name.  Kor  example. 

NCP>5ET    NODE     TESTEry    CIRCUIT    DMC-o 

establishes  circuit  DMC  0  as  the  circuit  over  which  loop  testing  takes  place. 
I  he  loop  node  name  is  necessary  because,  under  normal  operation.  l)K('net 
routing'  software  decides  what  path  to  use.  The  loop  node  name  overrides  tfie 
routing  function  to  route  information  over  a  specific  circuit. 

Next.  Use  the  NCI'  command  tc*  loop  messages  over  t  fie  line  through  the 
loopback  ((.nnedor  to  the  loopbac  k  node  name  TKS'I'KH.  (Kor  a  more  exten- 
sive te-t.  v(.u  can  run  the  .NTHS'I  .('Ml)  jjn.cedure  described  in  Section  2.\:2. 
When  \  rKS'f  asks  you  if  it  is  an  internal  test,  answer  NO.) 

NCP-LOOF    NODE     TESTER    iDUNT     i- 
NCPSWOW    Girv'.JiT    DHC--,    CCUN-rEPS 

A  -ample  <»f  the  summarv  displayed  is  shown  below: 

CircMit  rn><<-'*.9T<-     35  of  '>I-t1AP-83  ''9: 5^:15 
C  1  r c  M  1  I  =  DMC  -0 

22G       Secor,  .js     since     lasi     reroej 
87       T^rminaiiiif    pac^'els     recei"(f<j 


0 


8  7   0  r  1  9  1  1 1  a  t  1 1 ,  s  p  a  c  f  e  i «.  s  e  r,  t 
Transit  pac>eis  recei'Pl 
"'ran  sit  Packets  sent 
Transit  congestion  loss 
0   C  I  r  c  M  1  I  .jowr, 
'-'   I  'I  I  t  1  a  1  I  r  a  t  1  0 1,  failure 
^378   Btes  f<»cei"e.j 
^3  78   B, tts  sent 

Data  tlocfs  receive. j 
Data  1 1  0  c  f  s  s  t  r.  i 
0   Data  errors  i  r.  b  o  m  r,  .1 
0   Data  errors  o  m  t  b  o  m  i ,  .J 
Rtmo  r  *>  r  ep  I    t  i  mtO'.it  i 
Local  r  e  p  1  .  t  i  m  e  o  n  t  s 


143 


U      Local     t'lffpfprrors 

It   an\    of   tfie   last    five  counters  shows  a   non/ero  \alue.   sec-   Section   L!.2,<i: 
c»t herwi.se  enter  the  following  command  to  show  .system  cMinters; 

^'CP    t^HDw    S.'STEM    tfJUNTEr^S     ^ 

A  sample  of  the  summar>  displascd  is  shown  below: 

Sv»te.»i    CQijnitr?,    as    of    01 -MAP- -83    '»9:?G:a:: 

I860  5 1  c  0  r.  <J  s  »  1  r,  c  e  1  a  s  t  i  e  r  0  e  .J 

0  Control  b ■ .  f  f  e  r  allocation  f  a  i  1  e  j 

0  Small  b  'I  f  f  e  r  allocation  f  a  i  ]  e  -j 

0  L  a  r  i  e  b  n  f  f  e  r  a  1  I  0  c  a  t  I  0  r.  f  -1  i  1  e  .1 

0  rvecei'-e  buffer  allocation  faile-j 
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Krrors  indicjitcd  hv  I  he  sv-tctii  ((Miiifcr  siimin;n\  (an  he  (  nrrtH  led  l)\  im  icms- 
iim  tin-  miml)t'r  n\  l)iillcr>  whose  all.u  it  ion  t.iili'd.  I  '>c  (  VE  to  Mu>dit\  >>>ltiii 
ImtltT  parariu'ttTs. 

\<'\t.  »'ji(rr  the  cfitiiiiiaiid  t"  --Iimw  the  cxccntdr  node  (  nimtc-f^: 


NCP     SHQW    E:'ECJjTi)fi    COUNUP''S 


A  saniplc  (if  the  ««iininiar\  di^-plaxcd  i>  sfidwn  hclnw 


No<j»    co'.inttrs    as    of    ol-MAr'-BD    t>9j?6s23 

ExBC'itor      iO'J<?     -     la     'NODE  A  I 

19SZ       Secori.js    sjf,  re     last     :  e  ^  oe  1 
1011  7Ga      P  .  i#5     rtce  1  "e.j 
101 176 a       e    les     sent 

177^5       Me5sa*p^     recei"?'! 

M  e  %  5  a  *  e  s     5  e  n  t 

C  0  n  n  #  c  t  s     r  e  c  e  1  "  p 'J 

Cor.  ri»cl5S*rii 

fVesPor,  %#     tjmeo  'I  ♦  = 

Ty  e  c  e  1 II  c  'j    connect     f  e  s  o  m  r  c  e    errors 

Total     'n  a  X  1  w  M  m    1  o  f  i  c  a  I     1  i  n  M    a  r  t  i  "  e 

6  9  e  '1    p  a  f  t  p  t     1  0^  s 

Nole     "i-oachat'lff    i»ac>et     Irisi. 

No'jp    0''     ofraiiSe    pac>et     Inc.', 

0"er5ir»'JpacKet  loss 

P  a  c  >  ^  t     f  0  r  in  a  t    e  r  r  0  f 

Partial     r  o  m  t  i  n  g    m  p  -j  a  t  e     lot-'; 

'.'e  r  1  f  I  c  a  t  1  or.    r  #  j»c  t 

N  0  '1  e    m  a  X  1  <n  1 1  (II     I  0  «  1  c  a  1     ]  i  r.  >  s     a  c  t  i  • '  e 

Total     r  e  c  e  I  "  e ' j    c  o  r.  n  e  c  t    r  e  s  o  •"  r  c  e    «?  r  r '.  r  i 


i7-'a5 

9 

9 

0 
11 

(> 

11 
ll 

f  ) 

i;» 
1 1 
(I 


("heck  the  suMiniarics.   It  the  (ntintcr'-  were  /crocd  hcli.rc  the  test,  t  ficii  thr 
laf«'^f  ^iimrnar\   ««li()uid  sh«»\v  f(jiii\al(Mit  \aliU'H  tnr  the  lollnum^  j).iir>: 

Circuit  Counter  Pairt 


r«'rmiii(«tim:  |><i(k«t-  rciciwd 
OriKin<ifin>!  |»m«  ki-i*  H»Tit 

I  r,iii«it  |);i(  kit*  rr<»'i\»'(| 
I  r,n!«if  |).ii  k(f»  -ni' 

h.itii  MI'M  k»>  r»'(  »'i\i(l 
I ).ii;i  H\i<(  k-  «»'ni 

I >iiU\  t-rroT"  iniMiiirul 
l);if ;i  »-rr'ir»  niilhuiirul 

Ki'rnolr  r«|)l\  tiiiM'<.iM» 
].'<(  i\\  rrpK   tirFM'oiil-. 


Node  Counter  Pairs 

\Ii  »«,ii:«>.  r((  (  i\c(| 

\lt--,ll,'«'»    -t'Dt 
(   nlllU'ct!.  %viU 


bfiiind.  romote  rf|)l\  timcniifs.  arid  l'>cnl  rcpK  liTii('(Mit>.  11  rn>  errors  arc  fmind. 
prtKcrd  to  S«M  fmn  j  :j.;{,  p  errors  arc  fniind.  see  Sec  f  ion  J/JJ). 
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2.2.3    Restoring  the  Node 

Now  that  the  test  is  complete,  the  circuit  must  be  restored  to  its  normal  state. 
This  involves  removing  the  loopback  name,  removing  the  hardware  loophack 
connector,  or  setting  the  line  back  to  controller  normal  (from  controller  loop- 
back). 

I'se  the  NTP  CLEAR  NODE  command  to  remove  the  loopback  name.  The 
loopback  name  is  TESTFIR  so  enter: 

NCP  CLEAP  NODE  TESTER  CIRCUIT 

Next,  remove  the  hardware  loopback  connector.  Note  that  the  circuit  status 
returns  to  the  on-starting  state.  The  time  it  takes  to  return  to  the  on-starting 
state  depends  on  the  listener  time  for  the  circuit.  The  default  value  s|)ecified 
in  NETCiEN  is  'M)  seconds.  A  sample  of  the  event  message  displayed  is  shown 
below: 

E  ^ '  e  n  t     t     p  e    J  .  7  .    C  i  r  c  i,  i  t     .j  o  'j  n     -  c  i  r  c  '  1 1  t,     f  a  l'  1  t 

Occurred    ul-riAR-83    li.':"5:15    on  >-,  o  .j  e    lU     'NODEA) 
Circuit    DMC-'"' 

Adjacent    ri  0  'j  e    1  i  s  t  e  i"i  e  r     receive  t  i  m  e  o  n  t 

II  a  F)MC\I)MH.  I)MI\  or  DMV  device  was  previously  set  to  controller  loop- 
back,  you  must  set  the  device  back  to  controller  normal  (the  default  state) 
with  the  following  commands: 

NCP :5E^  CIRCUIT  DMC-0  STATE  OFF 

NCP  SET  LINE  DMC-O  CONTROLLER  NORMAL 

NCR. SET  CIRCUIT  DMC-0  STATE  ON 

The  local  node  level  communications  circuit  testing  is  now  c(»mplete.  ^'ou  can 
be  confident  that  the  local  software  and  hardware  are  functioning  properly 
and  can  connect  to  a  remote  node.  Proceed  to  Section  2.'-\. 


2.2.4    Setting  Line/Circuit  States 

When  NETINS.CMD  performs  the  N('[»  SET  SYSTEM  command,  all  lines 
that  have  been  previously  set  to  ON  (during  NETCiF^Nl  are  enablerl  After 
NETCiEN  is  completed,  there  are  two  ways  you  can  enable  or  disable  lines. 

N'ou  can  either  change  the  permanent  data  base  by  using  the  Configuration 
File  Editor  (CFE'  commands,  or  you  can  use  the  Network  Ccmtrol  l^rogram 
(NC!^)  commands  to  enable  a  line  for  the  currently  running  system. 
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Using  CFE.  It  you  want  to  i-nahlc  a  line  usin^'  CFK  commands,  modify  tlu* 
permanent  data  base  either  before  you  execute  XKTINS.CMI)  or  before  vou 
do  the  next  XCP  SKT  SYSTKM.  To  enable  a  line  using  CKK,  enter 

CFE   DEFINE  LINE  //>(♦•/(/  STATE  ON 

If  you  want  to  disal)le  a  line  thai  has  been  j)reviously  set  to  ON.  enter 

CFE       DEFINE    LINE    liiu    id    STATE    CLEARED 

Using  NCP.  It  sou  want  to  enable  a  line  or  circuit  usin^  \CV  commands, 
enter  the  following  commands  after  the  NKTINS.CMI)  file  completes  execu- 
tion; 

NCR       SET    LINE    liru-nl    TOP 

This  command  loads  the  associated  process  in  the  top  of  meinory. 

NCP       SET    CiryCUIT    tinuit-ui    STATE    ON 

This  command  enables  the  ciriuit. 

If  you  want  to  disable  a  line  that  ha>  been  previously  set  to  OX.  enter 

NCP       SET    CIRCUIT    nnuitid    STATE    OFF 
NCP       CLEAR     LINE     linrid    ALL 

2.2.5    On-Starting  Substate  Error  Handling 

Tne  test  cannot  be  run  if  the  circuit  ^tate  is  on-starting.  Examine  the  hard- 
ware l()opf)ack  connector.  Be  sure  it  is  [)ioperly  installed  and  conforms  to  the 
specifications  in  Apj)endix  A.  It  you  are  using  a  modem  with  the  analog 
loopback  capability,  see  if  special  strapping  is  required.  See  Section  A. 2  on 
type  2(>1('  modems. 

Xext.  use  the  X('I>  SHOW  LIXK  Imr-id  ('HAHA(TKRISTI(\S  command  to 
check  that  the  line  has  been  set  to  full  du[)lex  mode  (even  though  you  may 
have  selected  half  duplex  during  XKT(iKX).  Half  duplex  mode  may  have 
been  specified  in  the  network  generation  procedure,  I'se  X(T*  commands  to 
change  the  controller;  for  example. 

MCP  SET  CiryCUlT  DMC-0  STATE  OFF 

rsjCP  CLEAR  LINE  DMC-0  ALL 

MCP  SET  LINE  DMC-0  DUPLEK  FULL 

NCP  SET  LINE  DMC-0  CONTROLLER  LOOPBACK 

NCP  SET  CIRCUIT  DMC-0  STATE  ON 
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If  the  circuit  could  not  he  set  ON,  check 

•  For  resource  allocation  prohlems.  XCP  SHOW  SYSTKM  rOl'NTP:RS 

should  show  no  errors. 

•  That  CSRs  and  vectors  were  properly  specified  during  NP^TOF.N.  If  they 
were  not,  correct  them  hy  means  of  NCP  or  CFE. 

•  If  a  device  was  included  in  the  RSX  system  during  SYSC.KN  and  also 
included  at  NKTdKN.  If  it  was.  the  following  message  will  appear  when 
loading  the  network: 

N  T  L  -  '.'  e  c  t  0  r    1"!  0  t     a  "  a  1  1  a  t'  1  e 

If  this  condition  occurs,  you  need  to  change  the  hardware  vector  and  CSH  of 
the  device,  as  well  as  modify  the  network  permanent  data  base,  (or  re-SYS- 
(IF^N).  Otherwise  check  with  field  service. 

See  the  DECrut-RSX  yrtuorh  (Ivncrotion  and  Installation  (htidv  for  de- 
tailed SYSGKN  requirements.  If  the  circuit  is  still  in  the  on-starting  state  use 
the  NCF  SHOW  CIRCriT  COUNTERS  command.  Check  the  summary.  If 
bytes  received  and  bytes  sent  are  zero,  the  communications  hardware  is  at 
fault.  Have  Digital  field  service  verify  that  the  device  and  c(mnector  have 
been  properly  installed. 

Three  lommon  hardware  failures  that  occur  are: 

•  The  communication  device  fails  to  interrupt. 

•  The  modem  and  or  line  corrupt>  the  data  being  transmijted  or  received. 

•  Communication  device  addresses  (CSR  and  vectorl  are  improperly  set  on 
the  interface. 

Common  symptoms  of  this  type  of  failure  are: 

•  Inability  to  turn  on  a  circuit 

•  Inability  to  complete  the  tran>|)ort  initialization  operation 

Most  other  types  of  failures  are  documented  by  appropriate  error  messages. 
^'ou  should  take  advantage  of  the  extensive  status  and  error  counters  main- 
tained by  the  DKCnet  RSX  system  to  aid  in  trouble  shooting.  Refer  to  the 
DKinvt  RSX  Sxstcm  XfanoMcr's  (iuidc  for  descriptions  of  the  various  count- 
ers and  procedures  for  displaying  them. 

2.2.6    Line  and  Circuit  Counter  Error  Handling 

The  following  errors  indicate  problems  r€»quiring  Digital  field  service: 

•  Errors  indicated  by  circuit  counters  with  receive  overrun  errors  qualifiers 
can  indicate  that  the  communication  device  is  installed  at  the  wrong  device 
priority.  For  example,  a  bus  request  plug  may  not  be  installed  at  HRo. 

•  Data  errors  inbound  or  outbound  indicate  a  hardware  device,  modem,  or 
line  problem. 
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2.3    Remote  Node  Software  Testing 

111   this  tot.   all   the  network   la\<'r>  i\n'  tc-tcr 
taken  throuiih  the  \ariniiv  javcrs. 

2.3.1    Preparing  to  Run  the  Test 


i.   Kiuiirc  L'  .")  (Ic|)i(t>  the  path 


I'fcparc  the  sNvtcin  hir  ihc  Ic^t   [)\   means  n|  tliese  >te|)s: 

1.  1m-  the  NCPSHOW  KNOWN  CIHCriTS  (■...nniaiui.  Il  v-Mirdnuit  i^  m 
the  nn-sfarlir^.^  suhstate.  prncecfi  to  Section  2.:;.".  t<>r  ncn  Im  liernet  (le\  u  o 
and  Section  :'..',.  |  [or  Kthernet  devices.  Kollow  the  procedures  in  those 
sections  |(,  uct  the  circuit  state  to  ON.  1 1  the  cin  nit  state  is  ON.  proceed  to 
the  toilowin^  step.  For  Kthernet  devices,  vmi  i  an  test  am  adiaccticv  ire 
mote  node  on  the  Kt  tiernet  i  that  is  reacliahle  I  sc  t  lie  N('l'  SHOW 
NODK  mxii'id  (f>!iimand  to  deteriiune  it  an  adiaceiit  \   is  reachahle. 

-•     ('l«'ar  all  the  ountt-rs  used  in  previous  le^t-  hv  eiUeritii:  'he  NCI'  /KI^O 
(  Ol   N  I  KKS  coiiuuands.  uu  hiding  svslem.  executor,  and  (irciiit. 


NOTE 

For  remote  tesiv  milv .  hot  h  I)'1'K  and  KAK  mn-l  he 
the  remote  node  hetore  voii  can  run  NTKS'I  .(  MI ) 


installed  on 


• 


2.3.2    Running  the  Test 

'I'here  are  two  methf.ds  (.{  testing.  One  method  ux-s  the  .N'lKS  T  ('MD  tile,  the 
other  method  uses  OKCnet  utilities.  Nmi  can  use  either  method.  When  tesfm<: 
is  ((.mpieted,  displav  all  counters  usin^  N(  T  commands  Re  sure  to  include 
cnciiit.  node,  executor,  and  svsten)  counters,  j'airs  ol  counter^  will  no  lonu-er 
mate  h  on  the  local  tiode.  hut  errors  should  he-  noted  and  lorret  ted  Reler  to 
the  l)l:(  nrf  HS.\  S\'>h-n)  .Xfntuinir's  (iindi  lor  intormation  on  cortcctin^  er 
rors  indicated  hv   the  network  coun!ers. 


2.3.2.1     NTEST.CMD  —    This  test   is  the  same  as  the  one  desc  rihed  m  Sec  ti(.n 
-!.].-'.  witli  one  exception.  Instead  ol  answeruiL'  the  <jue.stion.  K  this  an  inter 
nal  node  test,  witli  a  ^■.  answer  with  an   N    Then  to||o\v    the  procedure-  de- 
sc rihed  m  that  scctioti. 
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Figure  2-5;    Remote  Node  Software  Test 


2.3.2.2  DECnet  Utility  Tests  —  W  h.n  ;ill  cut  nits  luivc  hccii  vcnlicd  i..  I)r  in 
till"  ( )\  -t.iic.  inn  <Mv  oi  ihr  DKCniM  ntilitics  lisicd  jn  'Tiibh'  :.'  I  I  t  ilit  u-.  ;irc 
lisU'd  i\]  (lt's(  cndnii:  <'r(|('r  dt  prclcrcncc.  The  l)l"S  \)\\{  test  |s  tnorc  thdroimh 
ih.ui  fhr  Mfhcis.  \Nhi(  h  is  win  it  is  the  prch-rrcd  tc>t.  The  tjihic  >p('(  itics  llic 
a\iidfil)ilit>  (•!  I'.        tt'>l  on  cu  h  n|  the  |)K('tict  pnuincts. 


Table  2-1 

TEST 

hi-  hIR 
Nh  I   i  ,\i, 

I!  K  I  -\ 


Utility  Availability  on  DECnet  Nodes 

REMOTE  NODE  TYPE 
DECnet-RSX     DECnet-20     DECnet-RT     DECnet-E     DECnet-VAX     DECnet-IAS 


Yep 


Yes- 


Yes 


Yrv 
Yes 


YcK 
No 


Yf.H 

Yps 


*     AN«ilnhlc  triiii)  ■»(i|iw.ir(   -lui  wihst 

DTS  DTR,  In  .>rdcr  ti.r  tfic  D'lS  \y\'U  nlilitv  t..  run.  D'l'R  nin-t  l»c  inM;illcd  .it 
the  rciTintr  n  »dc  I'tic;  urncrnl  tornnit  tor  I)'l  S  is  shnsvii  hclnu.  lollowcd  l>\  ;in 
cxiiinpU'    Full  drtaiU  on  I)  IS  \)\\{  ;iic  ^:i\cn  in  .Appendix  IV 

Format; 

\^\^  [ni>drfi(tn,,[aii]]::    TKSr   /\/>f     rKINT   < /jo/n-] 
(rill  is  op(i<)i.;ii  access  cofifrol  infornintion. ) 
Example: 

DTS    PEMNODt  :  /  TE.ST  ^DATA 


• 


NFT  FAL.  In  order  for  \|-"I  t,,  pcrtorm  a  lile  operation  to  a  remoti'  node.  K.\L 
must  he  installed  ,»t  the  remote  node. 

C-e  W'V  to  transfer  a  copv  of  the  l.fV'l  .'J'STARTriVCMI )  file  to  the  remote 
isnde  and  then  hack  fo  the  local  node.  '!  hen.  tisc  I'll'  to  oiitpn'  the  file  and 
determine  whetl  the  file  uas  transmitted  and  rcd-ived  correi  tlv.  (N'on  (an 
Use  the  ('Ml'  iit|.  t<)  (oinpar«'  the  tuo  version.s  of  the  file  i  Ati  example  is 
shown  he!(»w. 


I^FT     ri-EINOD^  l*)  .10/PA5WD!  :  'LBs  n  .rJSTAfVTuP.CMD 
NFT      -OPMNOD/ I"  .1M/PA5WU J  jSTARTUP.CMD 

PIP     M  ! 'STArvTUP.CMD 


Note  that  the  file  i-  fransferrcd  from  the  hunl  node's  (*iril.2!  tr»  (he  remote 
node's  I  IC  Hi.lO  Ihe  file  is  iheti  retnrnefl  to  th»'  local  node's  I'lC  Access 
control  information  is  ^iven  in  the  example,  hut  (  an  he  defaulted  if  an  alias 
node  name  is  spec  itied. 
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For  more  information  on  \FT,  refer  to  the  DECnet-RSX  (hudc  to  User  Utili- 
ties. There  may  be  special  file  considerations,  if  the  remote  node  is  not  RSX, 
as  the  syntax  of  the  specified  file  can  differ  from  that  expected  by  NFT. 
(Check  the  appropriate  system  documentation  for  details.) 

TLK/LSN.  In  order  for  the  TLK/LSN  utility  to  run.  LSN  must  be  installed  at 
the  remote  node,  and  an  operator  must  be  present  to  respcmd  to  the  message. 
The  command  syntax  for  single  message  mode  is  shown  below,  followed  by  an 
actual  example. 

Format: 

>TLK  [tar^ctnodc-.'MTTn-Xmessa^c 

{TTn:  defaults  to  the  console  device.) 
Example: 

.>TLK  REMNOD::IF  THIS  MESSAGE  IS  RECEIVED  r  WE  HAUE  SUCCEEDED. 

For  information  on  the  use  of  TLK  on  RSX  systems,  refer  to  the  l)K(- 
nvt-RSX  (hiidc  to  I'svr  rtilitics.  When  using  TLK  on  other  systems,  check 
the  appropriate  system  documentation. 

2.3.3    Non-Ethernet  Error  Handling 

The  circuit  state  must  be  ON  in  order  to  run  remote  tests.  If  the  circuit  has  a 
substate  of  STARTINCi.  the  remote  operator  should  make  sure  that  the  re- 
mote node's  corresponding  circuit  also  has  been  set  to  the  ON  state.  If  the 
STARTINC;  substate  persists  upon  reexecution  of  the  NTP  SHOW  KNOWN 
riRCriTS  command,  use  the  NCP  SHOW  EXECTTOR  (CHARACTERIS- 
TICS command  (shown  below)  to  see  whether  transmit  and  receive  passwords 
have  been  set  on  the  local  system.  If  pa.sswords  have  been  set.  make  sure  that 
the  passwords  are  the  same  on  the  remote  node.  An  example  using  the  execu- 
tor node  follows. 

NCP    SHOW  e;;ecutor  characteristics 

This  command  displays  the  following  information: 


n  ,n  ,  '■) 


Node  cKi  ar  ac  I  e  r  1  5  I  1  c  5  as  of  Ol-JUN-83  13:3^:15 

Enecuior  r.  ode  =  16  (EOUI'.'N) 

I'Jenl  1  f  icat  lor,  =  EOWVN  BL  19  DECNET-  Management   'ersioi, 

Host  =  IG  'EOUYN)»  Loop  couiit  =  1.  Loop  length  -  ao 

Loop  '..  i  t  h  =  Mixed.  NS  P  "  e  r  s  i  o  n  =  U  ,0  ,0 

M  a  X  1  f»i  I.I  m  1  1  n  f  s  =  1  '.I  .  R  0  M  t  1  n  3  ■ '  e  r  s  i  0  1 1  =  2  ,  0  .  ("»  ,  T  ,  p  e  -  R  o  '  1 1  i  n  g  I ',' 

R  0  i.i  t  1  ii  s  timer  =  3 0 0 

MaKimi.im  address  =  ^00.  MaKimum  circMiis  =  G.  Ma'-imum  cost  =  l''t2; 

M  a  X  1  m  1.1  m  h  o  p  s  =  1  <:•  .  M  a  x  i  m  m m  "  i  s  i  I  s  =  2 'i 

M  a  X  1  (ti  1.1  m  b  r  0  a  d  c  a  s  I  i-i  0  1-1  r  0  '•  t  e  r  s  =  3 Z 

M  a  X  1  m  1.1  m  b  r  0  a  d  c  a  s  t  r  0  M  I  e  r  s  =  1  <> 

T  r  a ii  s  m  1 1  p  a  s  5 1.1 0  r  d  =  .  .  . 

'.'  e  r  1  f  1  c  a  1 1  0  r.  s  I  a  t  e  =  0 1 . 
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If  passwords  have  been  set.  they  must  have  been  set  ap|)r()i)riately  on  i)t>th 
nodes.  It  the  passwords  are  not  identieal.  or  it  a  password  was  set  at  one  node 
and  not  at  the  other,  the  following'  event  messajies  are  jjenerated  at  the  two 
no'ies  (provided  that  the  event  loj^^ier  has  been  enal)led): 

•  Message  at  node  requesting  password: 

E"erit     T-pe    4.G    '.'erificaliori    Reject 

From    Node    9     (HATvIFD*     Occvrred    05-Fet-83     1  "^ :  1  G  :  Z  1 

•  Messages  at  node  with  incorrect  or  missing  transmit  password: 

E  ■  ■  e  n  t  T  V  F  e  a  .  1  0  .  C  1  r  c  ■ '  1  t  U  p 

From  Node  a     'BOSTON^  Occurred  0?-Fet.-83  r':lG:55 

Circuit  DMC -  1 

E  "  9  I'l  t  T  ,  p  e  4.7  Circuit  D  o  ".<  ri  .  Circuit  Fault 

From  Node  a     'BOSTON*  Occurred  "5- Feb -83  1'^ :  1  7  :  i  Z 

Circuit  DMC- 1 

It  a  requesting  node  does  not  receive  a  password  or  receives  an  incorrect  one.  il 
restarts  the  node  initiaHzation  process. 

To  ensure  that  passwords  are  set  correctly,  reset  them  on  both  the  local  and 
remote  (RSX)  nodes  by  using  the  following  commands: 

NCP    SET    E'ECUTOrv     TRANSMIT     PA55W0PD    pn^^L  nrd 
NCP    SET    E    ECuTOrv    FvECEI'-'E    PASSWOrvO    pa»u  nrd 

where  passu  nrd  is  1  to  8  .A.SCII  characters. 

NOTE 

The  transcit  password  on  the  local  node  must  be  identical  to 
the  receive  password  on  the  remote  node.  Some  non-HSX  (tper- 
ating  systems  may  require  a  lull  8-character  ASCII  password 
tor  connection  to  an  RSX  operating  system.  For  VMS  nodes, 
passwords  are  set  on  a  per  circuit  basis. 

If  the  circuit  is  still  in  the  STARTINd  substate: 

•  Check  that  the  hardware  and  software  device  line  speed  settings  and  dui)lex 
mode  are  the  same  on  both  nodes. 

•  On  local  coaxial  cable  links,  check  that  the  transmit  cable  is  connected  to 
the  receive  cable  on  the  remote  node. 

•  If  a  null  modem  cable  is  being  used  for  KIA  asynchronous  communication, 
check  to  make  sure  the  cable  conforms  to  the  null  modem  wiring  diagram 
(see  Figure  A-61. 

•  If  your  device  is  a  DLll  type,  check  the  XETCiKN  specification  tor  that 
device.  If  it  was  not  XFTClKNed  as  a  DLll  WA,  that  DLll  must  have  all 
KIA  signals  including  request  to  .send  iRTS)  and  clear  to  .send  (CTS). 


r 
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•  For  connectiriK  DMP.  DMV  or  DMH  devices  to  a  DMC  device,  check  flint 
all  three  clevites  are  set  to  DMC  compatibility  mode.  When  coiinectinK 
DMP,  DMV,  and  DMH  devices  to  other  DMP.  DMV,  oi  DMH  devices,  both 
devices  in  the  pair  must  have  DMC  compatibility  m..de  enabled  or  disa- 
bled. 

•  Check  the  interface  installed  in  your  node  against  the  fy,Ts  listed  in  I  able 
A-1.  If  your  interface  is  not  listed  in  the  table,  the  network  ,  oftware  will  not 
function  correctly.  For  example,  a  DLl  1  F  is  not  the  same  as  i  DLl  I  K  and 
does  not  have  full  KIA  functionality. 

•  If  your  device  supports  switch  settings  that  supercede  software  s.  ttjuus, 
check  these  options  (for  example,  the  mode  switches  on  D.MP  and  D.vU' 
devices). 

When  the  nodes  are  physically  connected  and  the  hardware  communications 
devices  are  functicming  properly,  the  circuit  c-ounts  i  bytes  sent  and  bvtes 
received)  increment. 

If  the  S'r.\H'ri.\(;  substate  persists  and  the  circuit  count  (bvtes  received)  is 
not  incremented,  the  hardware  is  probably  at  fault. 

If  DDCMP  line  communication  has  been  established,  the  bytes  sent  and  bvtes 
received  counters  are  incrementing,  and  line  errors  a-e  not  occurring,  check 
other  sources  of  possible  software  incompatibilities  (f(.r  examj)le.  maximum 
node  address  or  large  data  buffer  sizes). 

Local  software  resource  alloc-ation  failures  can  .au.se  line  svnchroni/a'ion  to 
be  lost.  Cse  the  SHOW  SVSTKM  COINTFHS  command  to  see  if  allocation 
failures  have  occurred.  Then,  increase  the  number  of  buffers  that  have  alloca- 
tion failures. 

It  is  important  t'.  note  that  the  DKCnet  local  node  software  and  hardware 
verification  procedures  must  have  been  followed  on  both  rK.des  (sec  Secii.ms 
2.1  and  2.2). 

Kvents  logged  on  the  console  help  locate  the  problem  (provided  the  logging 
console  has  been  enabled).  For  more  information  on  hardware  loopback  u'sts. 
refer  to  Anpendix  A. 

When  all  lines  have  been  verified  to  be  in  an  ON  state,  return  to  Section  2. a. 2 
and  run  the  test. 

2.3.4    Ethernet  Error  Handling 

The  circuit  state  must  be  ON  and  the  adjacency  (the  remote  node  ..n  the 
Kthernet)  must  be  reachable  in  order  to  run  remote  tests.  If  the  adjacency  i> 
not  reachable,  the  remote  operator  should  make  sure  thai  the  remote  n(»des 
corresponding  circuit  has  been  .set  to  the  ON  state. 
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2.3.4.1    Problems  Connecting  to  the  Ethernet  —    It  the  circuit  is  still  in  the 
STAK'I'lNd  suhstate, 

•  dunk  that  the  CSH  and  VKCTOH  set  in  the  software  mateh  the  CSH  and 
\'K("!'()K  set  in  the  hardware 

•  Check  that  the  transceiver  cahle  is  connected  properly  on  local  cable  links 

•  Perlorin  the  hardware  veritication  described  in  Section  A.'\ 


When  the  nodes  are  physically  connected  and  the  hardware  communications 
devices  are  tunctioning  properly,  the  circuit  counts  (bytes  sent  and  bytes 
received)  irurement. 

I-Aents  lo^'^ed  on  the  console  help  locate  the  problem  (provided  the  lo^^nn^ 
console  has  been  enabled).  The  following  event  conlirms  when  the  connection 
to  the  Klhernet  has  occured: 

E  '  I  e  1 1 1     I  .  p  e    4  .  1 ' '.)  t    C  1  r  c  M  1  t     i.i  p 
Occur  reJ    l-Jur,-83    11:22:05    on    node    lb     'EOWrN* 
C  1  r  c  M  1  t    U  N  A  -  C) 


If  the  STAHTINCi  sulistate  persists  and  the  circuit  count  (bytes  received)  is 
not  incremented,  the  hardware  is  probably  at  fault. 

2.3.4.2  Problems  Connecting  to  the  Adjacency  —  II  communication  has  l)een 
established,  the  bytes  sent  and  bytes  received  counters  are  incrementing,  and 
line  errors  are  not  occurring,  check  ot  her  sources  ot  possible  software  incompa- 
tibilities  (lor  example,  maximum  node  address  or  large  data  buffer  size). 

Local  software  resource  allocation  failures  can  cause  line  synchronization  to 
be  lost.  If  this  occurs,  use  the  SHOW  SVSTKM  COrNTKRS  command  tosee 
if  allocation  failures  have  occured.  Then,  increase  the  numbers  of  butters  that 
have  allocation  tailures. 

It  is  important  to  note  that  the  DKCnet  local  node  sottvvare  prctcedures  have 
been  tollowed  on  both  nodes  (see  Section  2.1).  You  should  also  perform  the 
hardware  veritication  procedures  described  in  Appendix  A  to  help  isolate 
hardware  problems. 

If  passwords  have  been  set  for  your  local  node  as  well  as  tor  the  adjacency  that 
you  are  trying  to  reach,  you  must  verity  that  the  passwords  have  been  set 
appropria'ely  on  both  nodes.  See  Section  2.-\.'\  tor  a  discussion  involving  prob- 
lems related  to  passwords. 

The  following  event  contirms  when  the  adjacency  is  reachable: 

E  "  e  n  I  I  ,  p  e  a  .  1  5  •  A 'j  J  a  c  e  n  c  ■/  u  f» 
Occurred  l-Jur,-83  11:22:06  on  node  IG  (BOSTON) 
Circuit  UNA -(I 
Adjacent  node  =  19  (HArvTFD) 
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Figure  2-6:    Node  Level  LoopbacK  Tests  Using  DECnet-supplled  Software 


2.4  RSX-11S  Testing  Restrictions 

\I(i-«I  (it  iIh'  h'^t^  (Icv(mIu'(I  in  tin-  ili;ip!ti  laii  l>c  pet  Id  iiii-d  cii  .1  |»i"|»fil\ 
(.'oiilij^uit'd  l<S\    1  IS  ncdc. 

riic  N'iKsr.('Mi)  |)?i>(((iiiic.  h(iu(\(f.  ( juiii'it  iif  Mill  ,it  Ksx  lis  ii(mI(-  ii 

NI'KST.CMI)  i>  run  at  .in  KS\  UM  M  I'l.l  >  ixlc  :\^ii\u-\  an  HS\  11^ 
nndr.  tin-  Idc  tran-tti  Ic-t-  will  tail,  and  the  I )  TS  ic-t--  mas  lad  dcpcndinu  on 
the  (f'lilimuafH'n  of  'lie  icnintc  Hv^icin  IJdWfsci.  nioNt  dt  the  nctui'tk  inan- 
a^t'int'tit  rt'inniand-  nccdctl  tot  liMidiitiliK  tc-t  an  l<S\  1  I  >  nude  aic  a\  ailahic 
with  \(!'  Ml  NICK. 

K>\    IIS  >\sU'iii>  (In  iimI    have  tn  he  ((intiuuifd   uith  an\    ncluoik   manage 
nu'iit   ta^k'*    V><r  nntial  tr-titii:.   it   i*.  i^ofid  pra(ti(c  tn  ifi«.tall  \(|'  .md  \|('l'", 
atid  then  later  i('inn\('  itic  Ia>k-.  il  nc(Cs-ar\. 

NOTE 

K'.r   KS\    IIS  svstcniv.    \('l'  and    \|(   K  arc  -nl»M't-  .-f   tlinsc 
ntilitir-  -Mpportcd  in  Ks\    1  1  \l   M    I'!.!   S  v\  .tcni-. 

it  l''.\l,  I-  in>t,dlrd  and  fixed  nn  the  |{S\  1  IS  trndc.  mmi  (an  tran-tei  d.ii.i  tn 
and  tmni  unit   rect'id  de\u('>.  NKTddc-  nni   run  mm  KSX    II  s  •^\>ten.>. 

In  addilinn.  the  |)TR.  ILK,  and  LSN  la'-k-  (an  he  in-talled  and  lixed  <'ii 
RSX  I  1  S  nude-  it  I  he«-e  t  a-k-  are  Ii>  he  n-ed  I  »  I  "^  (  aiui"!  he  run  "ii  K>\  I  I  "^ 
node- 

2.4.1    Guidelines  for  Using  NCP  and  NICE  for  RSX-11S  Systems 

•  Using  NCP.  \(   \'  t^r  |^s\    1  ]S  -vstcm-  d.-e-  umI  .uppnii  |,()()|'  ClRCl   IT 

le-t-.. 

•  Using  NICE,  it  \hii  are  uonm  t^  ii>(.  i,n( )!'  \(  )i  )!•,  with  a  l<.n|)l)a(  k  (  mi«;ic(  - 
tor.  the  loop  nod(    ( ;m  he  -el   up  with  \  \l'  01    Ml'. 

NICK  tor  RSX    1  Is  ,s.|,.M)- (|o(.v  iK-t  -upport  l,()(  )|' -  "IKi  TIT  te-ts, 

NH  K  lor  K.sX  MS  -\^tein-  doc^  not  allow  loophaek  le-^t-  Irotn  r»'inote 
node-.  I'll  perlorin  ihi-  t  s  pe  o|  te>t.  the  loophack  mirror  (MIIT  J  niu-'  he 
m-talled  on  fh(    -\-tem  and  detmed  a-  ohieet  J.") 

\|(  K,  to|  RSX  1  IS  sN-tem-doe-  not  .upport  SHOW  LIXKor  SHOW  I.IXK 
(TI.AK.VC  I  KRI.s  lies.  h,)t  dor-  return  inlnrmation  |..r  SlMM.Mn'. 
S  lAII  S.  and  CO!  XIKlTS  See  the  Ifl'.Cnrt  HS\  S\sh'n,  Mnndun's 
(luidr  lor  delail- on  the  XK'K  (otnniand-  -upported  h\   KSX    IIS  nodc.'^. 

2.5  Summary 

Ki^urcs  2  •>  and  L'  7  illu-lrate  and  suniinari/e  the  kind-  ol  le-t-  th.it  are 
iiNfidahle  Xote  that  the  le-t-  (an  he  run  U'^in^;  tiefwork  inanauernent  utililie- 
(ir  >o|twar(' that  run  at  t  fie  I'-er  ia\cr  Kir  niore  itilorinaf  ion  011  ruiinmu  node 
level  te^t^.  svc  A\>\H'lu\\\  A  and  the  l)l\(  n*  t    l{S.\  S\s(rni  Mfina^rr's  (liiidr. 
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Figure  2-7:    Node  Level  Loopback  Tests  Using  User-supplied  Software 
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Chapter  3 

Node  Configuration  Guidelines 


This  chapter  describes  ^uideHnes  for  tonfi^'uring  your  DKCnet  node  t(»  assurt^ 
|)roi)er  network  routinji  operation.  The  information  j)resented  here  assiiino 
that  you  have  performed  \KT(iKN  and  have  verified  thrt  the  node  operates 
properly.  'I'he  information  in  this  chapter  pertains  to  the  operation  of  l)olh 
your  node  and  other  nodes  in  your  network.  If  a  node  in  your  network  is  other 
than  a  DKCnet  HSX  node,  refer  to  the  appropriate  system  mana^erV  ^aiide 
for  information  al)out  managinjj  that  node. 


3.1    Avoiding  Routing  Problems 

To  avoid  network  routing'  pn)hlems.  adhere  to  the  following  ^uideHues  when 
confiKurin},'  nodes: 

•  .Xssi^ni  a  unicjue  address  to  each  node. 

•  Specify  the  same  maximum  node  address  for  all  nodes.  This  will  ensure  that 
all  routing  tables  are  the  same  length. 

•  Make  the  large  buffer  size  the  same  for  all  nodes  in  the  network.  This  will 
ensure  that  the  large  buffer  and  segment  buffer  sizes  are  adequate  for  each 
path  in  the  network.  (NKT(iEN  will  provide  the  largest  segment  buffer  si/c 
permissible  for  the  large  buffer  size  specified.) 

•  I'se  the  same  list  of  remote  node  names  for  all  nodes. 
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3.2   Consequences  of  Ignoring  the  Guidelines 

The  likely  consequences  ot  ignoring  these  guidelines  are: 

•  Two  nodes  have  the  same  address  (not  name).  When  two  nodes  have 
the  same  address  (not  name),  one  of  two  situations  can  result: 

II  the  path  costs  to  send  messages  to  these  nodes  diller.  messages  are 
always  directed  to  the  node  with  the  lower  path  cost. 

If  the  path  costs  to  .send  messages  to  these  nodes  are  the  same,  messages 
are  always  .sent  only  to  one  of  these  nodes  (as  individually  determined 
by  system  implementation). 

In  both  cases,  messages  can  be  received  from  both  nodes,  but  can  be  sent 
only  to  one,  as  described  above. 

•  The  maximum  address  on  a  node  is  larger  than  that  on  an  adjacent 

node.  When  this  situation  occurs,  routing  information  is  lost  at  the  adjacent 
node.  Those  nodes  who.se  addresses  are  greater  than  the  maximum  addre.ss 
are  unreachable.  The  following  event  me.ssage  occurs  when  a  routing  mes- 
sage is  received: 

E-ent  l.PP  a. 5,  Partial  rout  ins  update  loss 
From  node  13  (  SFTv  )  occurred  13- FEB -83  ()8:22:3S 
C  1  r  c  u  1  t  D  U  P  -  ij 

A  remote  node  is  unreachable  if  its  addre.ss  is  higher  than  that  specified  in 
the  routing  table. 

•  The  large  buffer  size  of  an  intermediate  node  is  smaller  than  the  seg- 

ment  size  of  the  source  and  destination  nodes.  When  this  situation  occurs, 
the  node  adjacent  to  that  intermediate  node  cannot  f(»rward  the  packet  and 
logs  the  following  message: 

E  "  e  n  t  a  .  3  0  "  e  r  s  1  z  e  ij  p  a  c  ^:  e  t  1  0  5  s 

From  node  19  (  SFfv  *  occurred  13-FEB-83  <J9:39:2B 

Circuit  DUP-0 

P  a  c  f;  e  t  h  e  a  d  e  r  =  A  1  2  '7  3  1  2  a  0  2 

If  event  K)gging  is  not  enabled,  it  may  appear  that  nothing  is  happening.  If 
the  mismatch  is  between  the  local  node  and  an  adjacent  node,  execute  a 
SHOW  .NODE  nodr-id  COfXT  command.  C^heck  the  counters  for  oversize 
packet  loss.  An  example  using  nodv-id  SFR  is  given  below. 


3-2    DECnet-RSX  Postinstallation  Checkout  Procedures 


:-NCP  SHOW  NODE  SFP  CO'^r 

Node  c  0  M  r.  t  e  r  5  as  of  1  3  -  F  E  B  -  8  3  1  Z  :  5  0  :  ("i  3 

Executor  ri  o  'j  e  =  19  (  S  F  R  ) 


Z31  13 

G5314G 

6?3iaG 

15532 

15^G7 

G5 

G5 

0 
9 


1 

() 
0 
I") 


5  e  c  0  1 1  'j  5  5  1  I'l  c  e  last  ;:  e  r  o  e  J 

B  ■  I  e  5  r  e  c  e  1  "  e  d 

B  '  t  e  s  5  e  11 1 

Messasies  receii'ed 

Mes5a3e55erii 

C  0  ri  ri  e  c  t  s  r  e  c  e  i  "  e  d 

C  0  I'l  ri  e  c  t  s  s  e  ii  t 

R  e  5  p  0  ri  5  e  timeouts 

P  e  c  e  1  "  e  d  c  o  I'ni  e  c  t  r  e  s  o  '.i  r  c  e  error 

M  a  "  1  m  u  in  logical  links  a  c  t  i  "  e 

Aged  pacf:et  loss 

Node  I.I  i-i  r  e  a  c  h  a  b  1  e  p  a  c  ^  e  t  loss 

Node  0  u  t  -  0  f  -  r  a  ii  3  e  packet  loss 

Qi'ersi^ed  packet  loss 

Packet  format  error 

Partial  r  o  u  t  i  ri  3  u  p  .j  a  t  e  loss 

'.'  e  r  1  f  1  c  a  t  1  0  n  reject 


Note  that  the  oversized  packet  loss  counter  is  1. 

To  correct  the  problem,  determine  the  present  setting  ot  the  sejiment  butter 
size  for  your  local  and  destination  nodes  an  1  the  large  butler  size  on  the 
node  that  is  causing  the  oversized  packet  loss.  Then,  either  increase  the 
butter  size  ol  the  intermediate  node,  or  decrease  the  segment  butter  size  at 
the  source  or  destination  node. 

On  an  RSX  node  use  the  \CP  SHOW  SYSTEM  CHARACTKRISTICS  and 
SHOW  KXK(TTOK  rHARACTP:RISTirS  commands  to  determine  the 
large  butter  and  segment  butler  sizes: 

NCP  SHOW  SYSTEM  CHARACTER  I BT I T B 

5. stem  characteristics  as  of  13-FEB-83  12:5B:1G 

1^  a  X  1  m  u  m  c  o  u  t  r  o  1  b  i.i  f  f  e  r  s  =  2  2  •  f1  a  h  i  m  u  (n  small  t'  'j  f  f  e  r  s  =     13 
M  a  H  1  m  u  rn  1  a  r  3  e  buffers  =  17.  L  a  r  3  e  t'  'j  f  f  e  r  sire  =  280 
M 1  n  X  !n  u  w  r  e  c  e  i  '  e  ti  j  f  f  e  r  s  =  3 

NCP  SHOW  EMtCuTGR  CHARACTERISTICS 

Node  characteristics  as  of     12-JUL-83  lia:31:2a 

Executor  riode=19(ELR0ND) 

Identification  =  DISTRIBUTED  SYSTEMS  •  Man  a  Semen t  version  =  U .0.0 
Host  =  19  (ELRGND).  Loop  count  =  1.  Loop  length  =  aO 
Loop  ui  1  t  h  =  mixed.  NSP  "ersion  =  ^.0.0 

0  .  R  0  u  t  1 1-1  g  "  e  r  s  1  0  i-i  =  2  .  ''.> .  <:•  .  T  /  p  e  =  R  o  u  t  i  n  3  I '.' 

0''i 

0 1)  .  M  a  X  1  ut  I.I  m  circuits  =  8  .  M  a  x  i  m  u  m  c  o  s  t  =  1  0  2  2 
M  a  X  1  m  u  t!i    h  0  p  s     =     1  2  .    M  a  X  1  m  u  (ti     n  1  s  1  t  s     =     2  ^ 
M  a  X  1  iti '  MTi    b  r  0  a  d  c  a  5  t    )'(  0  I'l  r  0  u  t  e  r  s     =    3  Z 
M  a  K  1  m  I.I  (ti    t'  r  0  a  d  c  a  5  t    r  0  u  t  e  r  5    =     1 ') 
5  e  « (Ti  e  n  t    t'  u  f  f  e  r     5  1  :  e    -    5  7  G 
'.'  •  r  I  f  I  c  a  1 1  0  ri    s  t  a  t  e    =    0  r, 


Maxim  I  i  m  1  1  ri  K  5  = 

Uo u  t  1  n  9  timer  =  30 

Maximum  address  =  3  0 
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On  a  VAX  node  use  the  NCP  SHOW  KXHCl'IOK  ('HARA( "  I'KRIS  IK  S 
(•(tninianci  to  (ietcrniine  the  huge  buller  si/e. 

Now.  increase  the  hirge  hut'ter  size  on  the  interniediate  node  with  the  !«.||..u 
in^  comniand: 

CFE  DEFINE  SYSTEM  LARGE  BUFFErv  SIZE  512 

With  the  DKFINK  eomniand  above,  you  have  increased  the  })iiller  >\/v  tn.tn 
2S0  bytes  to  .")12  bytes.  'I'he  ae(e|)ial)le  ran^e  lor  buller  .si/e  i-  Imm  llL'  in 
1  tSi  bvtes. 

An  alternative  to  increasing  the  lar^e  buller  ^'\/v  is  to  reduce  the  c\t(  nf«.r 
segment  >i/e  with  the  loJiowitiK  comniand: 

CFE     DEFINE    EXECUTOR    SEGMENT    BUFFER    SITE    ZG7 

'I'hi-  command  decreases  the  sc^juent  IjulTer  si/,e  from  ."iT(i  to  lT.J  iThe 
.icieptable  ranue  tor  scj^Mnt-nt  buller  si/e  \<<r  DKCnci  HSX  i^  tr.itn  17  1  fo 
I  IHJi  bytes.  I  l^emember  that  the  lar^e  data  buller  >i/c  mu>t  be  ,it  Ici-^i  \^ 
l)ytes  greater  than  the  segment  buller  size.  NK'I'CKN  initiabv  -»i»  the 
sejzment  buller  size  to  be  IS  bytes  les.s  than  the  i.jr^e  data  buller  >i/.'.  .uid 
CKK  will  also  check  lor  this  Is  hvtc  dillerence. 

NOTE 

rhan^es  to  the  larye  or  the  segment  buller  sizj'  are  !nade  to 
the  pernument  data  base.  'I'hese  (  han^'cs  are  in.t  relieved  m 
the  runmuK  data  base  untd  a  CLKAR  SNS'JKM  and  a  SKT 
S>S'IKM  command  are  perlormed. 
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Chapter  4 

Testing  the  RSX-11  PSI  Installation 


I'tii'-  (  li.iptrr  (l«"^(ii  !)(•>.  the  [ui  x  ('diirc  lo  lie  ()I)'^«t\c(I  I)\  w^cr-  <'t  ,i  (  onihincd 
l)K('n(*l  I'SI  (nnlimiriil  n'ii.  Tiir  priu  rdnrc  \  cMlif-  th.ii  fix  kS\  11  \'>\  -\s- 
t(-FJi  h;i-  been  umcriilcd  .ind  i!i-.tiill«'d  (  orrcc  1 1\  Ilic  (  h.iplcr  ,iUm  dc^(  rdic-. 
h"u  \n\\  (  ;in  f(  ^f  tfic  \.J!l  «>iiM\\arc  in  ('ji>iirc  that  it  li,i>-  Ix'Cii  m-^laljcd  ((•(■• 
r('(tl\  Sc(tin[i  }.,;  (dtitaiii'*  int«»ri!iaf  inn  nn  \cnl\mu  d.it.i  link  mapping,' 
1 1  d  ,\1 1  (  IK  Hit- 

4.1    The  Installation  Checkout  Procedure 

ri)«'  prnii'dtirc  iis».-.  tun  prn^rjims:   NTH  (X.J")  tc>t   ic((i\cm  .lud  S(  TX  I  S 
I  X  J">  i<'-t   >tti(h'ri.    riu'N    \<Til\    thill   \niir   I'>l   -vvictn  (  ati  -ct    'ip  a  (all  and 
M;in-tcr  data  hftwccn  \>>\\r  Nual   I )  TK  and  a   K-tiinic  I  )'|  K    >(    I'XTS   i-  pm 
\  idcfl  a-«  a  p(«'l)uilt   \  ,[^k  in  \niir  di>t  ribiitinn  kit.  .iiid  it  tnniinunK  at*--  with 
X  IR  runnmi:  nn  a  rcmnt»'  -\>t«tn 

4.1.1     Preparing  to  Run  SCPXTS 

Bcfnrc  \nii  (an  run  .s<"|'X'I"^.  \<mi  tnu>'t  huvc  ^cncr.'Ucd  jind  in^laHcd  \()ur 

K'^X    II    I'SI   ^N-tcni     A   checklist   '»!   tlic  stcpv.  \n!i   rnn-i  ha\c  pcrlnrrncd   i- 

mvcn  ht'lcu.  and  lull  (h't.iiU  (an  he  hHinrI  in  the  h"<\  II  /'s/  Htm  nitmn 
(luidr: 

•  Knn  .•^^  .^(  .K\  1  It  n('(  ('^^ar\  I 

•  Run  l'RK(.K\ 

•  Run  \KI(.K\ 

•  In-tall  liic  >\st<'iii 

<  )n(  f  \nii  iia\c  pcrfnrrncd  lh("»c  -icp--,  the  RS\  \\  |'s|  ,\«.i»iii  i^  up  and 
niiinitiL'  !•»  run  SCRXTS.  \nur  ucncratt'd  nystcrn  niu>t  vnl)s(rd)j'  In  the  npcn 
u-^»'r  t:rnup  and  niu-'  have  at  least  nnc  -.wih  hrd  virtual  (  ir(  uit  <S\'('). 
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4.1.2    Running  SCPXTS 

To  run  SCtWTS.  use  the  follow ing  lorniat: 
>RUN  ddu:\iiic]SCV\TS 

where  ddinluiv]  is  the  location  ol  SCT^XTS  after  NKTCIKN  isee  the  RSX  1 1 
PSI  (irnrration  (iuidc).  SCPX'I'S  asks  lor  the  address  and  suhaddress  ot  the 
remote  DTE,  as  lollows: 


I  r.  p  M  t     f  1.1  1  1    DTE    ad  d 


r  e  5  5     : 


The  answer  must  consist  of  the  1-  to  14-di^it  DTK  address  immediately  fol- 
lowed by  the  0-  to  4-digit  suhaddress. 


The  remote  DTK  must  he  a  machine  running  XTH  under  the  PSI  product. 
I'his  can  he  one  of  your  own  machines  or  any  other  suitable  machine.  It  you 
are  not  using  one  of  your  own  machines,  enter  the  address  provided  by  your 
field  software  support  specialist. 

SCPX  rs  will  then  run  lor  ."i  to  lo  minutes,  depending  upon  the  configuration 
of  your  system  and  on  any  other  tasks  running  at  the  same  time.  The  proce- 
dure tests  the  installation  of  the  HSX  1 1  PSI  product  by  setting  up  a  call 
between  SCPXTS  and  XTH.  These  programs  transmit  and  receive  oOO-byte 
long  data  packets  continually  for  three  minutes.  When  the  tests  stop,  t  e  call 
is  cleared.  When  the  tests  have  completed.  SCPXTS  produces  a  sumnii  y.  An 
example  of  a  summary  from  a  normal  run  follows: 

T  e  s  I    F  1  r,  1  s  h  e  d       ^ 

Test    Staiislics 

N  M  (»i  b  e  r    of     t  r  a  n  ^hm  i  s  -  l  3  (j 

N  I.I  (Ti  b  e  r    0  f     r  e  c  e  1  "  e  ?>  =  XQ(j 

I  )■(  t  e  r  r  I.I  p  t  s     c  0  (Ti  p  1  e  I  e  d  =  0 

I  I'l  t  e  r  r  1.1  p  t  5     received  =  0 

I  n  t  e  r  r  I.I  p  t  5    c  0  ii  f  1  r  III  e  d  =  0 

R  p  5  e  t  5    c  0  rii  p  1  e  t  e  d  =  0 

Tv  e  5  e  t  5     r  e  c  e  1  "  e  d  =  0 

SCPXTS  and  XTR  can  run  at  different  speeds.  Therefore,  the  number  of 
transmits  and  receives  reported  by  the  SCPXTS  summary  may  not  be  equal. 
However,  the  number  of  transmits  and  receives  should  always  be  approxi- 
mately equal  and  should  exceed  170.  A  summary  showing  f'ewer  than  170 
transmits  and  receives  does  not  mean  that  the  test  procedure  failed,  but  it 
could  imply  PSN  problems  such  as  noisy  lines  or  network  congestion. 

4.1.3    Error  Messages 

If  your  PSI  system  is  not  working  correctly.  SCPXTS  prints  error  messages  in 
the  following  format: 

'jflCP-F^-Errorjc  occurred 

where  x  is  an  error  number.  The  following  error  numbers  can  occur: 


• 
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Number        Meaning 


1 


•'() 


24 


Krror  in  iuldress/uscr  f^'rniip 

Intormatidn  mt'ssaKC.  Thi-  address  ..i  ilu-  rcinctc  DTK  was  in.t  >|)i'i  iiii-d  (■(irri(tl\ . 
Could  lint  >v\u\  x'tiip  mi'ssa^c 

Fatal  error.  A  data  traii.sniissioii  i-rror  occurred,  or  SCI'XTS  tailed  to  reach  XTM. 
Set  111)  iiies>a^e  was  not  satne  when  |)o|led 

Katal  error.  A  data  transn)is>io?i  error  occurrerl.  or  SCPX'I'S  tailed  to  reach  \'VH 
Could  not  assign  network  de\ice 

i'hi.s  error  can  occur  it  X'l'H  i>  not  >et  up  correctly.  '\'r\  the  test  auain  in  case  the 
network  was  the  cause  ot  the  error,  and  it  the  error  recurs,  ask  vour  sottware 
support  specialist  to  make  >ure  that  \'VH  is  jiijly  operational. 

IU'cei\e(l  (liat;no.stics  code  not  as  expected 

Warning  message    The  ( (HisistencA    check   on   n  clear  or  reset   diagnostics  code 
tailed.  This  means  the  c  lear  or  reset  was  generated  hs   the  network 

Hect'ived  cause  code  not  as  expected 

Warnint:  niessage.    Ihe  c  ousisteiu  \   check  on  a  clear  or  reset  cause  c'ode  tailed. 
This  means  the  (  tear  or  reset  \va>  jjenerated  hy  the  network. 

I)ata  received  not  as  expected 

Uarnin;:  niessaKe.    Ttie  cdiisisieiuv  check  on  incoming  data  tailed  due  to  a  data 
transinissidii  error. 

Clear  data  n<'!  as  expert  ted 

Warning  niessatie.  The  cdiisisiencv  chec  k  on  the  clear  data  tailed.   I'his  means  the 
clear  was  ^'cnerated  h\   the  network. 

Failed  to  set  up  with  XTH 

Fatal  error    .SCI'XI'S  tailed  t<.  reach  \'l'H 


Noil  are  advised  to  take  advanta;:e  of  the  extensive  status  and  error  counters 
maintained  by  HSX  II  PSI  to  aid  in  diagnosing  problems  (see  the  HSX  // 
/'.S7  S\.s(rni  Mdnaucr's  (iuidr).  Wni  may  also  need  to  test  the  physical  Hne 
iisiiiK  loopback  tests  (see  the  RSX    11  I'Sl  S\strm  Manager's  (iuidc). 

For  more  fletails  on  SCPXTS.  see  the  HSX   II  /'.S'/  (letwration  (iuidv. 
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4.2  Verifying  X.29  Installation 

To  verity  that  the  X.29  terminal  driver  has  been  correctly  installed,  use  a 
portable  terminal  and  acoustic  coupler.  Perform  the  lollowinj;  steps: 

1.  Dial  an  X.29  FAD  (packet  as.sembly/disassembly)  facility. 

2.  LoK  into  an  account  on  the  local  DTE. 

3.  Kn^^ajie  the  DTP^  in  a  simple  dialog'  by  usin^  a  tew  standard  commands, 
such  as: 

PIP/LI 

KDI 

4.  Log  out. 

See  the  RSX  II  I\S[  XctK  nrk-sprcific  Information  manual  Cor  further  details 
on  these  steps. 

4.3  Verifying  Data  Link  Mapping  Installation 

Once  you  have  established  that  your  local  DTK.  is  fully  operational  by  follow- 
ing the  procedures  described  in  Section  4.1.  check  any  DLM  circuits  that  may 
be  in  the  network  in  the  following  manner: 

1.  Knsure  that  the  DTK  is  ()\.  Knter  the  following  NC'P  command: 

NCP    SHOW    MODULE    ;;Z5  -  PROTOCOL    DTE    dtc-addrrss 

The  system  response  will  show  you  whether  the  DTK  you  are  testing  for  is 
ON  or  ()PT\  If  it  is  OFF,  turn  it  ON  by  means  of  the  NCP  command: 

NCP    SET    MODULE     -'25  -  PROTOCOL    DTE    dtr-addrf^s    STATE    OrJ 

2.  For  PVOs.  ensure  that  the  channel  numbers,  maximum  window  size,  and 
maximum  packet  size  defined  are  the  same  as  that  allocated  to  you  by  the 
Pl\SN.  To  determine  this  information,  enter  the  following  (FK  command: 

CFE  LIST  CIRCUIT  DLM-v.\  CHARACTERISTICS 

3.  For  SV'Cs,  check  that  the  usage  parameters  for  the  DIAI  circuits  are 
consistent  (sn  each  node  (one  side  must  be  outgoing  and  the  other  side 
incoming).  F.nter  the  following  CFK  command  for  each  circuit: 

CFE  LIST  CIRCUIT  DLM-v.\  CHARACTERISTICS 

The  node  response  will  >how  whether  the  circuit  is  incoming  or  outgoing.  If 
a  correction  is  required,  effect  it  by  means  of  the  following  CFK  command 
for  the  appropriate  circuit: 

CFE    DEFINE    CIRCUIT    cinuit-id    USAGE    Usnur 

where  usage      INCOMING  or  01T(;0IN(; 
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4. 


o. 


For  SV'Cs  you  should  also  verity  whether  or  not  the  maximum  packet  size 
and  maximum  window  size  will  be  negotiated  by  the  software.  It  the 
packet  size  and/or  window  size  is  a  value  other  than  zero,  then  either  one 
(or  both)  of  these  will  be  negotiated.  The  default  is  zero  (which  implies  no 
negotiation  with  the  network).  Therefore,  if  your  network  does  not  support 
negotiations,  the  values  for  the  packet  size  and/or  window  size  must  l)e 
zero.  I'se  the  following  commands  to  specify  the  maximum  packet  and 
window  sizes: 

CFE    DEFINE     CIRCUIT    DLM-.v.\     MA;.  I  MUM    DATA    hytr-count 
CFE    DEFINE     CIRCUIT     DLM-.v.\     MA  'I  MUM    WINDOW    hlochonint 

The  subaddress  of  the  outgoing  circuit  must  be  within  the  range  specified 
in  the  FSI  portion  of  NKTdKN  in  respon.se  to  the  question 

WHAT  IS  THE  TRANSPOryT  SUBADDRESS  RANGE"^ 

If  it  is  not.  correct  it  by  entering  the  CVK  command 

CFE     DEFINE    CIRCUIT    DLM-x.,     NUMBER    dtr-addrrss 

The  variable  dt('-addn:ss  consists  of  up  to  lo  digits  made  up  of  two  parts: 

•  The  I)TF/s  unique  address  within  the  network. 

•  Subaddress. 

The  length  of  dtc-cridrcss  depends  on  the  PSN  to  which  you  are  connect- 
ing. The  su!)address  is  the  low-order  portion  of  the  dtr-addrcss. 

In  testing  .S\'('  circuits,  be  aware  of  the  possibility  of  exceeding  the  maxi- 
mum number  of  re-calls.  If  this  number  is  exceeded,  the  circuit  will  go  to 
the  ON-KAIL  state.  This  would  be  reported  in  res{)()nse  to  the  WV  com- 
mand: 

NCP     SHOW    CIRCUIT    rimiit-id 

If  the  circuit  is  ON-KAIL  state,  first  turn  it  OFF  and  then  ON  by  using  the 
following  NCP  commands: 

NCP    SET    CIRCUIT    vircuitid    STATE     OFF 
NCP    SET    CIRCUIT    iinuit-id    STATE    ON 

Once  the  circuit  has  been  set  to  the  ON  state,  run  NTEST.CMI)  as  a 
remote  node  test  (see  Section  2.H). 
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Appendix  A 
Line/Circuit  Testing 


LiiU'/circiiil  t('>t>  jirc  a  >ci  i  U"«t-«  that  can  hv  \\-^v(\  \^^  ixilatc  line,  ciitiiit.  .iiid 
(l('\  n  ('  probk'tns. 

I.iiU'  ciri'iiit  \c\v\  lonphack  t("-t>  ((Hilirm  a  phv-^iral  link  l)\  lonpinL'  tc^t  data 
in  the  toUnu  m^'  \va\  >: 

•  'l'lirnu(,'h  a  liardwarc  loMphack  dcs  ice  on  the  line.  llirniii:h  a  niddciii  '(.t 
l("tpl)a(k  CDniicctori.  nr  thnuiuh  a  rcumtr  iiddc.  The  tot-  cnndiK  ted  u-^m^  a 
lonphack  idnnt'cttir  or  a  niddi'm  arc  calU-d  line  c  ircuit   Imtpliack  ti'>ts. 

•  H\  U'^iiiL'  tli('  -.(iltuarc  oj  a  rcniotc  sN^tcni.  'I'lic-c  arc  (ailed  -oltuarc  Indp. 
hack  l('>t>. 

•  H>  pcrlnirnin^  Kt  lie  met  Inophack  tc>t>  that  Inop  !iic-<«aue>  to  rcjnotc  dc\  ices 
on  the  Kt  hernet . 

Null  nia\  want  to  irntiate  a  >erie>  ol  operalion>  td  ie>t  \ariMii>  a>pe(t>  ol  a 
physical  link-lor  exaniple. 

•  I"o  atta(  h  a  joophack  connector  to  the  contidller  and  \v^\  to  >-ee  il  the  line  i«> 
tunctional  iisin^  a  line  loophack  test  (>ee  Se(tion  All 

•  I  o  ii>e  a  niodein  with  analog:  loophack  (  apahilifs  to  see  il  the  line  i-  tnnc- 
tmnal  (see  Sections  A  1 . 1  and  A.  1.1.1  i 

•  lo  perlnrni  a  loophack  test  to  another  node  to  sec  it  the  ph\sual  line  is 
operation.il  (called  a  software  hiophaik  lest)  (see  Sections  A.J  and  A    ii 

•  To  |)erforfn  Kthernet  lo(»phack  testitii:  t<'^ee  if  remote  (le\ii'es  on  the  Kt  her- 
net are  able  to  transmit  and  receive  messages  (see  Section  A.'i» 

I  'sc  t  he  \(  I'  L( )( )!'  ('IR(  l  ri'  command  to  perfortn  a  litie  c  irciiit  level  loop- 
hack  test.  When  \{»u  issue  this  command,  vmi  have  the  option  nf  citntroljnm 
the  tvpe  of  hinarv  information  (mixed,  ones,  /eroesi.  the  nnmher  of  hloc  ks  i.| 
information  (1  to  (;.").");{.')).  and  the  leimth  in  hvtes  of  each  block  il  to  (i.*).").{:. i  to 
he  looped  Line  le\cl  hardware-looped  tests  cannot  he  performed  with  l).\l(' 
and  l)MI<  devices  because  of  restrictions  unless  a  software  loophack  mirror 
provides  the  loophack  on  a  remote  system  (that  is  .  voii  »  annot  use  a  hardware 
loopbac  k  connectionl.  See  the  hKCmt  HS\  S\stru)  Mmumir's  dindr  I'T  the 
eomplete  syntax  of  the  LOOl'  ("IKCl  11   command. 
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Island 


(fOCPj       Th#  aiodulfl  that  itccspts  command  input 
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Th«  module  that  Mindt.  loopt.  and 
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Notes  1      At  controller 

2  At  modern 

3  At  loopt>a<.k  connector 


Path  travelled  by  tett  data 


-  —  —      Interface  butwaen  nodes 


The  UAtv  II  SERVICE  or  ON  (depends  on 
the  implementation) 


Figure  A-1:    Line  Level  Tests 


OMMtNITS 


The  controller  mini  Lie  mitnuiilly  set  to 
looph<:-:k  mode 


Modem  loophack  rtiid  circuit  loopback 
re(|uirH  either  rnHnual  setting  or 
nttalliition  of  loopl)iick  connector. 
See  Table  A  1 


The  crruit  state  of  Ixith  nodes  must  Iw 
ident.cal 


• 


• 


• 


It  your  message  returns  with  an  error,  the  test  stops,  and  SCV  prints  a  nies- 
safje  indicating  a  test  tailure,  the  reason  for  the  failure,  and  a  count  ot  the 
messages  that  were  not  returned  (see  the  DECnct-RSX  System  Manager's 
(iuide  for  the  NCP  error  message  summary)  -    for  example. 


NCP  SET  CIRCUIT  DUP-0  STATE  SERt.'ICE 
NCP  LOOP  CIRCUIT  DuP-0  COUNT  1 o 

NCP  --  Loop  fr:iile'Jt  lirie  protocol  error 
U  n  1  0  0  p  e  d  c  0  M  ri  t  =  8 

In  this  test.  10  messages  were  sent.  The  first  two  messages  were  sent  success- 
fully, and  an  error  occurred  on  the  third.  When  the  error  occurred,  the  test 
halted.  Figure  A-1  ilku-irates  both  the  hardware  and  the  software  loopback 
tests.  Refer  to  the  DECnct-RSX  System  Mnnai>er's  (iuide  for  more  informa- 
tion on  running  these  tests. 

A.1    Line/Circuit  Level  Test  Using  a  Loopback  Connector 

This  type  of  test  verifies  whether  or  not  the  device  and  cable  are  functional. 
Figure  A  '2  illustrates  a  line  loopback  test  with  a  loopback  connector.  See 
Figure  A-3  for  other  hardware  loopback  arrangements. 


NODE  BOS  (Executor) 


loopback 
/Connector 

NCP       1 

X 

1  onsss    ^ 

"CONTROLLER" 

LJ 

Figure  A-2:    Full  Duplex  Line  Loopback  Testing 

For  this  test,  put  the  circuit  in  the  SERVICE  or  the  ON  state.  (The  test  can 
be  started  from  either  the  (3N  or  the  SERVICF^  state.  However,  the  SFIRVICE 
state  is  the  preferred  state  for  this  test,  as  it  allows  testing  that  does  not  affect 
the  network  as  a  whole.)  Then  use  the  LOOP  (TRCT'IT  command  —  for 
example, 


NCP  SET  LINE  DUP-0  DUPLEX  FULL 

NCP  SET  CIRCUIT  OUP-0  STATE  SERVICE 

NCP  LJQP  CIRCUIT  DUP-0  COUNT  10 

NCP  SHOW  CIRCUIT  DUP-0  COUNT 
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This  set  of  c(>nimands  tests  the  physical  line  DIP  ()  up  to  the  loophaek 
connector.  A  user  can  exercise  the  local  node's  hardware,  including'  the  com- 
munications controller  and  the  cahle,  by  usin^  a  loopback  device  on  the  line 
during  a  line  level  loopback  test.  Certain  synchronous  communications  inter- 
faces do  not  supply  a  free  running'  v  lock  for  the  KIA  (Klectronic  industries 
Association)  interface  (Table  A-1).  This  clock  must  be  present  to  run  a  line 
loopback  procedure.  Therefore,  if  the  device  beinji  used  does  not  provide  a 
clock,  a  clocked  null  modem  (modem  eliminatorl  must  be  installed  between 
the  modem  cable  and  the  loopback  connector.  The  modem  eliminator  sup- 
plies a  clock  to  resolve  this  problem.  See  Fifiures  A-4.  A  5.  and  A  (i  lor  wiring' 
dia^'rams  of  the  loopback  connectors  and  the  null  modem  connection. 


Table  A-1 


Digital  Communications  Interface  Specifications  for 
Loopback  Processing 


Interface 
Name 

Interface 
Type 

External 

Loopback 

Connector 

External 

Loopback 

Capability 

Cables 
Required^ 

DC!  I   DA 

FIA 

H:u:. 

.\  e  e  (i  s 

('Idiked 
niod'Mn 

a 
null 

MCS!JS 

DllMl   DA 

FIA 

HM2.- 

.We  (Is 
clocked 
iiioderi. 

a 

null 

HC02C 

DVII 

ETA 

H<2-. 

Needs 
clocked 
inodt'iji 

a 
null 

FUO'D 

DMCII   Al/ 

Local  s 

vnc 

12   12.')2H 
loaxial      test 
tonneitor 

Yes-* 

HCfKiN 

DMni  AH 

with 

DMCll  DA 
line  unit 

HS2M:^ 

CCITT 

V.L'4 

(V 

m■I-^ 

Needs 
clocked 
modem* 

a 

null 

HC(i:.l) 

DMCll  AH*** 
with 
DMCll   FA 

line  units 

C(nT 

m-i'^o 

Needs 
clocked 
modem* 

a 
null 

* 

HCOAZ 

D.MPll  AA 

RS-2M2-C/ 
HS-42M  A 

H;v2r, 

HM2A1 

>es 

BC.^5C   10. 
BCOoD  2.-) 

DMPll  AA 

HS-2:}2 
RS-42a 

-C/ 
A 

HM2r, 

h;?2:i1 

Needs 
clo(  ked 

a 

null 

Hcr).")C  10 
and  null  mi 

modem 

(continued  on  next  page) 


*  With  DMCll-MA  or  DMCll  MD  line  units. 

•*  A  LOOP  CIRCl'IT  command  doe.s  not  work  with  thi.s  interface,  t'se  LOOP  NODE. 

•••  For  RSX  systems  only, 

t  The  cables  used  depend  on  the  type  of  modem  in  the  system 


• 


A-4    DECnet-RSX  Postinstallation  Checkout  Procedures 


Table  A-1  (Cont.):    Digital  Communications  Interface  Specifications  for 

Loopback  Processing 


Interface 
Name 

DM  I' 11  AR 
DMIM!   AC 


DMIMI   AK 

DMHll  A  A 

with  Hell  20(1 
niddt'in  i>r  etjuiv 

DMHlI   A  A 

DMHll   AH--- 

with  Hell 
r)(K)AI>l  o 
or  equiv 


DLll   K 


DIAll   K 

(LSI 

111 

1)1  V 

DA 

(LSL 

ID 

DZll 

A.H.H 

DZVll 

(LSI 

ID 

I'CLll 


Interface 
Type 

rrnT 

v.:r, 

Loial  syiK 
iit  'if^K  l)|)s 
or        1  Me^ 

KS   IL'J  A 

KIA 

ccir'r 

V._M 

KL\ 

HSIUt  I2:i 

('(ITT 
V.:r>I)DS 


KIA 
KIA 
KIA 

KIA 
KIA 

Parallel 


External 

Loopback 

Connector 


Hall  duplex 
switch  0  N 
and  cables  re- 
moved 

HH-T)! 


H.Ti.-i 


H.i-jr.l 
H:vjri(» 


DMHll  AC 

Local    svnc 

Hall     dupli'X 

4  selectable 

switch      ON 

speeds     up 

and  cables  re- 

to IM  bps 

moved 

DMHll   AK 

KIA 

H:i2o() 

with  Hell  MYM' 

HS449:ri_' 

type  inodenis 

HiJl.') 
H.'Vjr, 


External 

Loopback 

Capability 

>'es 
Yes" 


\(- 


Ve.- 


Ye 


e> 


\v: 


Ye 


^■es 

Yes 

Needs  a 
clocked  null 
modem 

Yes 

Yes 


Not  required  Yes 


Cables 
Required^ 


H("t»V/  2.") 


H('V,A  Kt 

and   Twinax  t  ables 


H( 

.-,.-,H 

1(» 

H( 

.V.D 

:\:\ 

H( 

o.')!) 

•J.') 

l)in 

H( 

:,:.l) 

:\: 

pin 

H( 

(C.Z 

25 

H((MN. 
HC.V.M. 
or  HC.'.'.N 

H( '»).")/  2.', 


Cable   supulifd    \v. 
kit 

HC(  ).')(• 


HCOoC 
HC(i.")I) 

Hciir 

HC2()K.  HC2()I' 


*  With  DMCll   MA  or  DMCll   MI)  line  units. 

**  A  LOOP  CIHCnr  command  does  not  work  with  this  interlace.  Ise  LOOP  NODK. 

*•*  For  RSX  systems  only, 

t  The  cables  used  depend  on  the  type  ot  modem  in  the  system. 
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•"•log  loopbMk 


loopbaeh  conrMctor 


RSX  OECn«t  nod* 


(■)  LoopiMck  connector 


(b)  Local  modMn  ^  R8X  OECnM 


remote  modem   y  difital  loofiback 


-• cable 


telephone  circuit  to  remote 
node 


RSX  OECnet  node 


(c)  Remote  modem 


Legend: 


teetpeth 


(d)  Connected  devicea         OECnet  RSX  node 


Figure  A-3:    Hardware  Loopback  Arrangements 
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A. 1.1    Hardware  Arrangements  for  Line/Circuit  Loopback 

Tlu'  hardware  arraii^enu-iit  tor  line  loopback  dcpuiuls  on  your  installation's 
inlertaff  equipment  and  the  hardware  coniponents  you  wish  to  include  in  the 
test. 

•  Loopback  connector.  The  loopback  connector  is  installed  on  the  cal)le 
between  the  line  device  and  the  modem,  as  shown  in  Figure  A  M(al.  This 
configuration  tests  the  line  device  and  the  cable.  'I'he  connector  returns 
digital  data  to  the  line  device.  You  must  condition  the  line  device  tor  tull 
duplex  m(tde  l)y  using  the  SKT  LINK  1)1  PI.KX  KILL  command. 

•  Connected  devices.  It  vou  ha\e  more  than  one  similar  line  on  your  system, 
you  can  use  two  lines  tor  line  loopback  by  i-onnecting  their  line  devices, 
either  directly  b\  way  ot  coaxial  cal)le  or  over  a  telephone  circuit  by  way  ot 
modems  as  shown  in  Figure  .-X  -Ud).  This  loopback  arrangement  tests  both 
line  devices  and  whatever  cables  and  modems  connect  them.  The  data  is 
not  forced  back  in  the  hardware,  but  received  by  a  device  at  the  local  node 
instead  of  at  a  remote  node.  This  is  analogous  to  having  two  telejihones  in 
your  house  and  using  one  to  call  the  other.  This  is  the  only  loopback  ar- 
rangement whereby  you  can  rur.  the  line  devices  in  halt  duplex  mode.  (Full 
duplex  mode  is  also  |)ermitted.) 

•  Local  modem  loopback.  Some  modems.  forexami)le  20H,A  and  2()SB  types, 
have  an  analog  loopback  (ALl  button.  The  button  directs  the  modem's 
transmitter  output  to  its  receiver  input.  This  loopback  arrangement  tests 
the  line  device,  the  cal)le.  and  the  modem,  as  shown  in  Figure  A  '^(b).  The 
modem  converts  data  from  the  device  to  analog  form,  digitizes  the  data 
again,  and  returns  it  to  the  device.  \n\\  must  condition  the  device  for  full 
duplex  mode  by  using  the  SKT  LL\K  DIPLF^X  FILL  command.  Note  that 
local  iTiodem  loopback  must  always  operate  in  full  duplex  mode,  even  for 
20HB  type  mofiems  (whose  telephone  circuits  are  halt  du|)lex). 

•  Remote  modem  loopback.  Some  modems,  tor  example  2()HA  types,  have  a 
digital  loopback  (I)L)  button.  The  button  directs  the  modem's  receiver 
output  to  its  transmitter  input.  A  remote  modem  set  in  the  I)L  state  and 
connected  to  the  local  modem  by  a  full  duplex  telephone  circuit  is  shown  in 
Figure  \  'Mv\.  This  loopback  arrangement  tests  the  device,  the  cable  to  the 
local  modem,  the  local  modem,  the  telephone  circuit,  and  the  remote  mo- 
dem. The  remote  modem  digitizes  data  from  the  local  modem,  converts  the 
data  to  analog  form  again,  and  returns  it  to  the  local  modem  (and  then  to 
the  device!.  "S'ou  must  condition  the  device  for  full  duplex  mode  by  using  the 
SKT  LINK  DliM.KX  FILL  command. 


Line/Circuit  Testing    A-7 


01  i^  h  i"  is  ie  0/  ^8  o9  oioi.ii.2o'3 1  «;:oQ.ou":r '° 

DL1 1  E    interfaces 
Ol4(j)15ol6(p17o18o19  ^20^21(^22023 (p24p25 


View  Looking  at  Back  of  Connector 


TERMINAL 

SIGNAL 

2 

SEND  DATA 

3 

RECEIVE  DATA 

4 

SEND  REQUEST 

5 

CLEAR  TOSEND 

6 

DATA  SET  READY 

8 

CARRIER/DETECT 

11 

SEC  Y  XMIT  DATA 

12 

SECY  REC  DATA 

15 

CLOCK  XMIT 

17 

CLOCK  REC 

20 

TERMINAL  READY 

22 

RING 

24 

EXTERNAL  CLOCK 

25 

BUSY 

SIGNALS 


SEND  REQUEST 

BUSY 

RING 

SEND  DATA 
RECEIVE  DATA 

EXTERNAL  CLOCK 
CLOCK  REC 
CLOCK  XMIT 

TERMINAL  READY 
CARRIER  DETECT 
CLEAR  TOSEND 

DATA  SET  READY 
SEC  Y  XMIT  DATA 
SECY  REC  DATA 


3 

=1 


25 
22 


3! 
3 


24 
1/ 


3 


20 

8 

5 

6 

n 

12 


Figure  A-^:    H315  Loopback  Connector  Wiring  Diagram 
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View  Looking  at  Back  of  Connector 
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Figure  A-5:    H325  Loopback  Connector  Wiring  Diagram 
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Figure  A-6:    EiA  Asynchronous  Null  Modem  Wiring  Diagram 
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Figure  A-7:    Typical  Breakout  Box 


A.1 .1 .1  Line/Circuit  Level  Test  Using  a  Modem  —  In  order  to  use  a  modem  in  a 
line  level  loopback  test,  the  modem  must  have  the  analog  loopback  options.  A 
breakout  box  (Figure  A-7)  may  be  required  to  allow  the  loopback  of  specific 
modem  handshaking  circuits  that  are  normally  set  OFF  when  the  modem  is  in 
an  analog  loopback  state.  (The  communications  software  requires  that  DA- 
TASET-READY  be  ON.  However,  some  modems,  the  Bell  201C  for  example, 
set  DATASET-READY  to  OFF  when  in  the  analog  loopback  state.) 

When  installing  the  breakout  box  between  the  modem  cable  and  the  modem, 
make  the  following  patches  across  the  DTE  side  of  the  breakout  box: 

•  Patch  DATASET-RP:ADY  (pin  6)  to  DATATERMIXAL-READY  (pin  20). 

•  Patch  RF:QrEST-TO-SENI)  (pin  4)  to  CLEAR-TO-SEND  (pin  5). 

Set  switches  5  and  6  on  the  breakout  box  t(t  OFF.  Set  the  remaining  switches 
to  ON.  The  DTE  side  of  the  breakout  box  is  the  side  connected  to  the  com- 
puter (as  opposed  to  the  side  connected  to  the  modem,  which  is  called  the 
DCEside). 


Line/Circuit  Testing    A-11 


A. 2    Software  Loopback  Test  (non-Ethernet  devices) 

I  se  the  LOOP  CIHCH'IT  command  to  perform  a  software  loopback  test  of  a 

physical  line  connected  to  the  local  node.  This  type  of  test  uses  DKCnet  HSX 
software  to  loop  through  the  physical  line  to  circuit  service  software  in  the 
adjacent  node  and  back  to  the  l(»cal  node.  Figure  A  8  illustrates  a  software 
Iooj)back  test  to  check  whether  or  not  the  circuit  is  operational  up  to  the 
remote  unit  and  controller  on  the  adjacent  node. 


NODE  BOS  (Executor) 


L 


NCP 


I 


LINSSS 


not  a  logical  link 


REMOTE  NODE 


) 


REMOTE 

LINE  SERVICE 

SOFTWARE 


Figure  A-8:    Software  Loopback  Testing 


For  this  test,  you  first  turn  the  circuit  ()\.  then  use  the  LOOP  riHCriT 
command: 

NCP  SET  CIRCUIT  DUP-0  STATE  ON 
NCP  LOOP  CirvGUIT  DUP-0  COUNT  10 

This  set  of  commands  tests  the  physical  line  Dl'P  0  up  to  the  adjacent  node. 


A. 3    Ethernet  Loopback  Testing 

P^thernet  loopback  testing  is  performed  in  order  to  test  remote  devices  on  the 
Ethernet.  Flthernet  circuit  loopback  testing  can  be  performed  concurrently 
with  other  DKCnet  operations  on  each  node  and  does  not  interfere  with  other 
Ethernet  traffic.  There  are  two  ways  of  testing  other  \  '\As  on  the  Ethernet: 

•  Loop  to  any  node  on  the  Ethernet 

•  Loop  to  a  specific  node  on  the  Ethernet 
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Vhv  I  \A  i.s  used  lo  loop  messci«,Ts  on  the  Ktheriict  circuit.  The  KthcriU't 
circuit  must  be  in  the  ()\  state  with  service  enabled  in  order  to  be  tested.  [\v 
the  tollouin^  commands  to  enable  service  and  to  set  the  Kthernet  circuit 
device  I'NA  (controller  number  01  to  the  ()\  .state: 

NCP  SET  CiryCUIT  UNA-O  SErv.iICE  ENABLED 
NCP  SET  CIRCUIT  UNA-0  STATE  ON 


A. 3.1    Random  Node  Loopback  Testing 

\n[\  can  use  the  tollowin};  command  to  send  a  test  message  to  all  nodes  on  the 
Kthernet  via  a  multicast  message.  The  first  node  to  respond  is  desitrnated  as 
the  test  node  (provided  that  the  COrXT  i.s  greater  than  1): 

NCP  LOOP  CIRCUIT  UNA-0 

NCP  LOOP  CIRCUIT  UNA-0  COUNT  50 

A  return  mes.sa^e  is  displaved  that  incHcates  the  node  (.n  the  Kthernet  that 
responded  to  the  looj): 


NCP  --  Loop  Succeede'l 

Ph/sical     Add  r  e-,  s  =AA -'")M-n4.  On.  23- (1-11  .     rjode 


35     'NODE;:* 


A. 3. 2    Specific  Node  Loopback  Testing 

Noil  can  specifv  the  physical  address  or  the  nc.de  name/address  lor  the  circuit 
nn  a  specilic  remote  node  that  you  want  to  test. 

NOTE 

Nodes  on  Kthernet  circuits  are  identified  by  uni(|ue  Kthernet 
addre.s.ses.  An  Kthernet  address  is  repre.sented  as  si::  pairs  of 
hexadecimal  dibits  separated  bv  hvphens  dor  exam|)le. 
AA  00  00  ();{  (IT  FK). 

Kach  device  on  the  Kthernet  has  a  uni(|ue  hardware  address  (in  read-only 
memorv)  that  has  been  assigned  to  it  bv  the  manufacturer.  DKCnet  .sets  an 
Kthernet  physical  address  for  each  IN  A  that  replaces  the  hardware  addre.ss 
as  the  address  to  that  the  I'XA  responds.  The  TNA  will  continue  to  respond 
to  the  Kthernet  physical  adfiress  unless  this  address  is  reset  to  the  hardware 
address  value.  (However,  the  Kthernet  physical  address  reverts  back  to  the 
harrlware  address  value  only  when  the  node  is  powered  OFF  or  rebooted.) 

NOTE 

"Physical  address"  refers  to  the  address  to  which  the  node 
currently  resf)onds.  This  address  could  be  either  the  hardware 
address  or  the  Kthernet  physical  address  set  bv  DKCnet. 
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^"oii  can  spei'ity  the  NODK  panunctiT  tor  tlu-  (U'\  iif  on  tlu-  rcinott'  ikkIc  tfiat 
you  wish  to  test.  'I'he  tollowiii^  conimand  loops  inessa^cs  ilirou^ih  the  local 
device  I  \A  0  to  NODK  NKl'Tl  N: 


NCP    LOOP    CirvCUIT    IJNA-O    NODE    NEPTUN 


Specityin^'  the  node  address  value  (such  as  22<)i  lor  the  NODK  parameter  also 
results  ill  a  sucee^slul  loophack  test.  The  tollowiu^'  coniniand  loops  messages 
through  the  loeal  device  I'NA  0  to  NODK  (address  valuei  -2<i; 

NCP    LOOP    CITvCUIT    UNA-0    NODE    22G 

\ini  can  aUo  specilv  the  I'H^'SICAL  ADDHKSS  paraiTieter  along  with  it> 
value  to  test  to  a  remote  node.  The  lollowing  command  loops  messages 
through  the  local  device  I'NA  0  to  the  remote  node  having  physical  address 
AA  (M)  (H  00  FF  OH: 

NCP  LOOP  CIPCUIT  UNA-O  PHYSICAL  AODTvESS  AA- On  -  ,.-3  ..mO  ..  ff  ■  ^g 

ll  a  remote  rmde  that  \(iu  want  to  loop  to  i>  not  running  DKCnet.  u>e  the 
I'H>'S1(".\L  ADDHKSS  parameter  along  with  the  hardware  addres.-^  \alue  lor 
tliat  node. 

A. 3. 2.1  Loopback  Test  Error  Message  —  II  a  loo[)l)ack  test  does  not  succeed, 
you  will  receive  the  tollowing  error  display: 

NCP    -  -     Loop     f  a  1  1  e  j  •     1  1  ii  e     c  0 m m '.n  1 1  c  a  t  1  0  ii     error     P  e  c  e  1  "  e  r 
U  ri  1  0  0  p  e  .j    c  0  i."'i  t,  =  1 

A. 3. 3    Loopback  Assistance 

For  Kthernet  loopback  testing  sou  can  u>e  an  assi>tant  ph\sical  address  and 
an  assistant  node  to  aid  \i>u  in  interrogalir.g  a  device  on  a  remote  node,  'j'he 
assistant  is  useful  when  vou  are  '  'hie  to  successtully  loop  to  a  remote  node, 
hut  it  i>  known  that  some  other  nooe  on  the  Kthernet  can  communicate  with 
that  remote  node. 

^olJ  can  Use  the  assi.otant  hv  specilvmg  the  appropri;ite  HKLI'  parameter  lor 
the  type  of  assistance  you  need: 

•  HKKP   i'H.\NS.\irr.  .•\>sist  in  trjuismitting  messages  to  a  remote  node. 

•  HKLI'  HK("KI\'K.  Assist  you  in  receiving  messages  trom  a  remode  node. 

•  HKLI'  M  I.K.  .Assi>t>  \(,ii  in  l>oth  transmitting  messages  to  and  receiving 
me.ssages  trom  a  remote  node.  This  is  the  full  sense,  or  (he  delault  method. 
of  using  the  assistant. 
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W  ht'ii  \t>u  have  to  ust'  assistaiuf  in  looping  to  a  reinote  node  on  the  Klhcrru't. 
this  indiiiitt's  the  existaiue  ot  a  hardware  problem  with  that  remote  node.  I'he 
tv|)e  ot  a>^istanee  that  you  use  will  depend  on  the  nature  o|  the  problem  on 
the  remote  node. 

It  you  speiifv  either  the  ASSIS'I'AN  T  PHYSICAL  ADDI^KSS  (.r  ASSIS- 
TANT N'ODK  parameter>  without  speiityin^  the  HKLP  i)arameter.  you  will 
reeei\e  lull  assistance  (that  is.  help  in  l)oth  transmitting'  and  receisin^  intor- 
mationi.  The  loll(»win^  commands  show  the  u.se  of  lull  assistance. 


^s 


•  In  the  tirst  example,  you  recjuest  the  node  with  Kthernet  physical  addre 
AA  on  DM  iKi  A}^  FC  to  assist  you  in  testing  the  node  with  Kthernet  phy.^i- 
cal  addres.s  AA  (M)  o:^  <K)  oK  08: 

NCP  LOOP  CIRCUn  UNA-0  PHYSICAL  ADDRESS  AA  - 'm-i  -  ri3 -'"">- OE  -  "h 
NCP  ASSISTANT  PH.'SICAL  ADDfyESS  AA  -  00  -  "3  - '.>0  -  AB  -  F  C 

•  In  the  second  example,  vou  re(juest  node  M.-\HS  to  assist  vou  in  testing  node 
S.-VriRN: 

NCP    L.0OP    CIRCUIT    UNA-0    NODE    c-ATijPN    nqcTcrANT    NODE    MARS 

You  can  also  specify  the  ASSISTANT  PH^■SK'A^  ADDRKSS  or  ASSIS- 
TANT NODK  parameters  along  with  the  specitic  HKLP  parameter  for  the 
t\pe  o|  assistance  you  dd.^ire. 

•  The  loll(«winu  command  speiilies  the  HKLP  KKCKIXK  parameter  to  re- 
quest node  M.AKS  to  assist  y(»u  in  receiving  intormation  tor  node  S.ATrHN: 

NCP     LOOP  CirvCUlT  UNA-U  NODE  ShTURN  nbbl  ..ImN;   UUut  MniVr,  ntur  i^clL  i  .'c 

•  The  tollowing  command  specifies  the  HKLP  TH.ANSMIT  parameter  to  re- 
quest the  node  with  (address  value  224)  to  assist  you  in  transmitting  infor- 
mation to  node  SA'n'HN; 

NCP  LOOP  CIRCUIT  lJNA-0  NODE  SATURN  ASSISTANT  NODE  2  24  HELP  TRAN5MI T 
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Appendix  B 

DTS/DTR  Test  Programs 


DTS  and  \)\\{  are  the  DKCnet    llM  M   Plus  transmitter  and  receiver  test 
proijram.-. 


B.1    Types  of  Tests 


There  are  tour  basic  tests  provided  b\  DTS  and  D'I'H: 

•  Connect  lest 

•  Data  test 

•  Disconnect  test 

•  Interrupt  test 

Each  test  is  divided  into  a  set  of  subtests.  The  tests  and  subtests  are  described 
in  the  (bllowin^  sections. 

B.1.1    Connect  Tests 

Connect  tests  verify  the  ability  ol  the  network  software  to  process  connect, 
connect  accept,  and  connect  reject  recjuests  with  and  without  optional  user 
data.  Connect  tests  that  the  user  can  pertorni  are: 

•  Conned  reject  without  user  data 

•  Connect  accept  without  user  data 

•  Conne'-t  reject  with  16  bytes  of  standard  user  data 

•  Connect  accept  with  IB  bytes  of  standard  user  data 

•  Connect  reject  with  received  user  data  used  as  reject  user  data 

•  Connect  accept  with  received  user  data  used  as  accept  user  data 
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B.I. 2    Data  Tests 

Data  tests  provide  a  full  ran^ie  of  test  tapahiliiies  from  the  very  simpL.'  data 
sink  operation  throuf^h  data  integrity  checkinfi.  Data  tests  the  user  can  per- 
form are: 

•  Sink  test.  DTK  ij^nores  all  data  received.  No  secjuence  (ir  content  validation 
is  performed. 

•  Sequence  test.  Data  messages  transmitted  by  DTS  to  DTK  include  a  4- 
hyte  .sequence  number.  If  a  me.ssage  is  received  out  ot  .sequence.  DTR  aborts 
the  logical  link  and  the  test. 

•  Pattern  test.  Data  me.ssages  transmitted  to  DTK  have  both  a  sequence 
number  and  a  standard  data  pattern.  If  either  the  .sequence  number  or  the 
received  data  does  not  match  the  expected  data.  DTR  aborts  the  logical  link 
and  the  test. 

•  Echo  test.  Data  messages  received  by  DTR  are  transmitted  back  to  DTS. 
There  is  no  sequence  or  data  validity  checking  done  by  either  DTR  or  DTS. 

B.1.3    Disconnect  Tests 

Disconnect  tests  are  designed  to  determine  whether  DTS  can  detect  the  differ- 
ence between  disconnect  and  abort  sequences  generated  by  DTR  as  well  as 
receive  the  pn.per  optional  user  data.  Disconnect  tests  that  can  be  performed 
by  the  user  are; 

•  Disconnect  without  data 

•  Abort  without  user  data 

•  Disconnect  with  \(]  bytes  of  standard  user  data 

•  Abort  with  16  bytes  of  standard  user  data 

•  Disconnect  with  received  connect  user  data  used  as  disconnect  user  data 

•  Abort  with  received  connect  u.ser  data  used  as  abort  user  data 

B.1.4    Interrupt  Tests 

Interrupt  tests  provide  a  full  range  of  test  capabilities  from  very  simple  data 
sink  operations  through  data  integrity  checking.  Interrupt  tests  that  the  user 
can  perform  are: 

•  Sinl<  test.  DTR  ignores  all  interrupt  data  received.  No  sequence  or  content 
validation  is  performed. 

•  Sequence  test.  Interrupt  messages  transmitted  by  DTS  to  DTR  contain  a 
4-byte  .sequence  number.  If  a  message  is  received  out  of  sequence,  DTR 
aborts  the  logical  link  and  the  test. 
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•  Pattern  test.  Interrupt  messages  transmitted  to  D'I'H  have  both  a  sequence 

number  and  a  standard  data  pattern.  It  either  the  sequence  number  or  the 

data  pattern  is  not  received  with  the  expected  data,  DTK  aborts  the  logical 

Hnk  and  the  test. 

"/■ 

•  Echo  test.  Interrupt  messages  received  i)y  DTK  are  transmitted  back  to 
DTS.  There  is  no  sequence  or  data  validitv  checking  done  bv  either  DTK  or 
DTS. 


B.2    Operational  Characteristics 

DTK  functions  as  a  shue  to  DTS.  DTS  initiates  each  test  by  issuing  a  connect 
request  to  DTK.  Parameter  information  pertinent  to  the  type  of  test  requested 
W  passed  l)y  DTS  to  DTK  in  the  optional  data  ot  the  connect  request.  DTS  has 
a  user  interface  that  enables  the  user  to  specify  the  test  to  be  performed. 
Sufficient  parameters  are  available  to  allow  for  a  variety  of  tests,  including 
test  duration,  buffer  size,  and  buffering  level. 

The  version  of  DTK  supplied  on  the  kits  supports  a  maximum  of  three  logical 
links,  thus  allowing  three  concurrent  tests.  DTS  can  handle  only  a  single  test 
and  logical  link,  but  the  user  can  invoke  multiple  copies  of  DTS. 

The  DTS  command  syntax  allows  for  two  tvpes  of  buffer  level  options:  BITS 
and  FLOW.  BIFS  is  used  by  DTS  only  and  FLOW  is  used  by  DTK  only.  The 
Bl'FS  parameter  specifies  the  transmit  buffering  level  for  DTS.  Thi.s  is  the 
number  of  transmit  requests  that  DTS  attempts  to  keep  outstanding  to  the 
network.  In  an  echo  test,  the  BIT\S  parameter  also  specifies  the  receive 
l)uffering  level  for  DTS.  The  parameter  of  the  FLOW  option  specifies  the 
receive  buffering  level  for  DTK. 

Both  DTS  and  DTR  have  512  bytes  of  buffer  space  built  into  each  task.  The 
buffer  space  is  at  the  end  of  each  task  image.  To  increase  the  buffer  space  of 
either  task,  the  user  need  only  employ  the  /INC  option  at  installation  time. 
DTS  requir-^s  m  'east  (BlTSMSCi)  bytes  of  buffer  space  of  a  data  test  and 
((Bl'FS. liMSC)  bytes  for  an  echo  test.  DTR  requires  (FLOWMSG)  bytes  of 
buffer  space  for  each  data  test. 
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B.3    DTS  Command  Syntax 


Formats  for  DTS  commands  are  described  below.  The  lollowiii^r  conventions 
apply  to  the  presentation  and  use  of  the  I)'I\S  commands: 


Conventions: 

Brackets  [  ] 
I'PI^EHCASE 

lourrcnsc  italic 

\o  space 
Defauh  values 


Designate  an  optional  parameter. 

Designates  the  actual  code  that  appears  in  the  call. 

Designates  a   parameter  that    is  replaced  with  an  actual 
value  when  assembled. 


Do  not  use  a  space  after  the  prompt    ^  in  a  command  strin 


Input 
Format: 


Values  specified  as  defaults  are  valid  only  tor  the  first  test. 
Before  the  conclusion  of  each  test.  DTS  updates  the  default 
values  with  the  parameters  of  the  next  test,  which  become 
the  default  values  for  the  next  test.  Thus,  it  is  necessary  to 
specify  only  those  parameters  that  are  to  be  changed  in  the 
next  test. 

DTS  accepts  an  indirect  command  file  as  input. 


DTS^[A7or/rA?r/mr[f/(/:]::[/TKST   /\prl[/PRI\T   chnivr] 
Arguments: 

nitdvnami' 

Name  of  the  node  where  DTS  resides;  the  default  is  the  local  node  name. 
The  name  must  be  terminated  by  a  double  colon  i::!  or  underscore  for 
Version  2  compatibility. 


(Ul 


Access  control  information,  in  the  following  format: 

[luscr-id[/passu()rd[/(uci)unt\\] 

Vor   more   information,    refer   to   the   DECmt  RSX   System    Manager's 
(ruidc. 


type 


Test  type: 

CON 
DIS 
DATA 
INT 


Connect  test 
Disconnect  test 
Data  test  (default 
Interrupt  test 
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chi>i( 


■c 


^'KS  (default  I  or  NO  to  indic-ale  whether  DTK  niessajies  are  to  l)e  printed 
at  the  remote  node  as  well  as  at  the  loeal  node. 


NOTE 

The  print  option  is  used  by  DTK  to  either  display  or  suppress 
message  output  to  the  local  console  device.  Messajies  include 
both  test  results  and  error  niessa«ies. 

B.3.1    Connect  Test 

Format: 

rONNKCTTKS'r  .'/\/;r][/I)ATA    data] 
Arguments: 

type 

Type  ot  connect  test: 

ACC  Connect  accej)t  test 

HK'I  Connect  reject  test  (delault) 

data 

Type  ot  user  data: 

NONK       No  optional  user  data  (default ) 
STI)  Standard  user  data 

HC'VD        Return  connect  user  data 


B.3.2    Disconnect  Test 

Format: 

DISCONNKCT  TKST S/ypfll/DATA   data] 
Arguments: 


type 


Type  of  disconnect  test: 

DSC  Disconnect  test  (default) 

ART  Abort  test 


data 


Type  of  user  data: 

NONK       No  optional  user  data  (default 
STD  Standard  user  data 

RCV'D        Return  connect  user  data 
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B.3.3    Data  Test 
Format: 

DATA  TKST   ;M/)rMS(;   /^/mm.i/HlFS   hhhn/T\\\K   titnr 
[/HAl  n   ruinnnn]A^\A)\\  Jlou] 

Arguments: 


/\/)f 


Type  (>t  (lata  test: 

SINK  Sink  tot  (delault  I 

^^M  St'(|ueiut'  tot 

I'A'!'  Pattern  test 

KCHO  K(h(.  test 


m  m  m 


Data  messa-e  length  in  bytes:  mmm  must  he  greater  than  o  tor  a  sink  ..r 
echo  test,  greater  than  1  tor  a  sequence  test,  and  greater  than  T)  tor  a 
pattern  test.  The  maximuni  vahie  is  lOlM  bytes.  The  detauh  is  the  NSp 


segment  M/e 


hhh 


I)  rs  transmit  buttering  level,  in  the  range  ot  1  to  lb.  'I'he  detauh  is  1 


time 


Test  duration: 

nnnS  seconds 

finn.\f  minutes 

nnH  hours  (maximum  is  IS) 

^''"?  detault>  to  .secj>nds 

The  detault  is  liM. 


nnnnnn 


Line  baud  rate  in  bit>  per  senmd  (detault  isO).  U  nnnnnn  is  specified  the 
percentage  ot  line  bandwidth  u>ed  by  data  transters  is  calculated.  Thi.s 
percentage  is  inaccurate  tor  baud  rates  exceeding  (vlK  bps. 


flou 


Flow  control  tvpe  or  DTK  receive  buttering  level,  in  the  range  ot  1  to  Hi: 
N"()\K  No  tlow  control 

SK(;:nn        Segment  tlow  control  (invalid  tor  HSX) 
MKS:nn       Mes.sage  tlow  control 

The  detault  is  .\IKS:1.  SVAr.nn  is  invalid  tor  HSX  DTK  because  the  net 
work  interlace  does  not  provide  that  capabilitv. 
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res 


B.3.4    Interrupt  Test 

Format: 

INTKHRrPI    TKSr    M/)rMS(i    ^^rn  ;  TIMK    timr 
Arguments: 

'Wpv  of  itiffiTupt  test: 

SINK  Sink  it'si    .U'lault  i 

SK(^  St'(nn.'iu('  \v>[ 

PA'I'  Palttrii  tt'>l 

KCHO  Kcho  tt'.si 


^ri  /r? 


Intfrrupl  nu'»a^t'  Icii^t  h  in  l)\  U'>:  'uni  mu>l  br  LMcattT  t  hau  <•  tor  a  >ink  or 
t'lhd  test,  lircatcr  tiiaii  \  tor  a  st-ciut'iuf  tt'>t,  and  ^Mi-altT  than  •">  tor  a 
patttrii  lf>t.   Iht'  niaxmiuni  value  (and  the  detaulti  i>  Hi  bytes, 


time 


Test  diiratioti: 

fintiS  second^ 

nnn.M  minutes 

finU  hoiir^  Miiaxiinuin  is  ISl 

nnn  detaults  to  >ec-onrl.s 

The  detaulf  i>  2M. 
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Index 


Account. 

privileged.  2-4 
Address, 
circuit. 

physical.  A-  \'\ 
CSR.  \  2.  2-16 
DTE.  4-2.  4  o 
DTE. 

subaddress.  4-2.  4-o 
F^thernet. 

format  tor.  A-IM 

physical.  A- 13 
hardware.  A-13.  A- 14 
maximum  node.  2-22.  2-23,  3-1,  3-2 
node  name.  A- 1.3 
node. 

assigning  of.  3-1 

for  Ethernet  loopback  test.  A- 14 

remote.  3-2 
physical. 

assistant.  A-14 
TDM.  2-9 

two  nodes  having  the  same.  3-2 
vector.  1-2,  2-16 
Adjacency, 
testing, 

on  the  Ethernet,  2-17.  2-22 
AL.  A-7 

Analog  loopback. 
>Vc  AL 


Assistance, 
Ethernet  loopback, 

purpose  of,  A-14 

u.se  in  problem  isolation.  A  15 
full.  A- 15 
help  receive. 

information.  A-15 
help  transmit. 

information.  A-15 


Baud  rate. 

See  Line,  baud  rate 
Breakout  box, 
role  in  loopback  test  with  modem, 

A-11 
rules  for  installing,  A-11 
Buffer, 
having  allocation  failure,  2-22,  2-23 
size, 
large.  3-1.  3-3 
large  data.  2-22,  2-23 
large, 
acceptable  range  for,  3-4 
increasing  the,  3-4 
segment,  3-1,  3-3 
segment, 
acceptable  range  for,  3-4 
reducing  the.  3-4 
BITS,  B-3 
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Button, 
loopback. 
analoji.  2  11.  AT 
di^jital.  .AT 


Cable, 
coaxial.  A-T 
null  modem.  2  LM.  A  4 
receive.  2-21 
testing  ot. 

with  loopback  connector.  A-T 
transceiver.  2-2M 
transmit,  2  21 
verifving  function  of.  A  A 
(TB,  2  8 
CFE. 
correcting  CSR  and  Vector 
specification  with.  2-lfi 
defining  circuit  usage  parameters  with. 

4-4 
defining  DTE  address/subaddress  with. 
4  5 

defining  maximum  packet  size  with. 
4-5 

defining  maximum  window  size  with. 
4-5 

determining  DLM  characteristics  with. 

4-4 
enabling/disabling  a  line  with.  2-15 
examining  network  component 

parameters  with,  l-.S 
examining  network  configuration  with, 

1  -:] 

increasing  re.source  allocations  with. 

2-8 

modifying  system  buffer  parameters 

with.  2-13 
modifying  the  permanent  data  base 

with.  2-14 
verifying  segment  buffer  size,  3-4 
Checkpoint, 
space. 
Sep  Space,  checkpoint 
Circuit. 
DLM. 

See  DLM 
PCL, 

See  PCL 
telephone, 
testing  of,  A-T 
Clear  to  send. 
See  CTS 


Clock, 
free  running, 
for  line  loopback  procedure.  A  4 
CMP.  2  19 
Communication, 
asvnchronous. 

EIA.  2-21 
line. 

DDCMP.  2  22 
task-to-task.  2-4 
Communications  c()ntrf)ller. 

See  Controller,  communications 
Configuration  file  editor. 

.Sec  CFE 
Connect  request. 

See  Request,  connect 
Connect  test. 

Sec  Test.  Connect 
Connector, 
loopback.  2-9.  2-11.  2  15,  2-25,  A-.i, 

A-4 
loopback. 
for  line/circuit  loopback  test.  AT 
Control  buffer. 

.Sec  CCB 
Controller. 

communications.  A-4 
Cost, 

path,  a-2 
Count. 

circuit.  2-22,  2-23 
Counters, 
bytes  sent  and  received.  2-22.  2-23 
circuit,  2-13.  2-lT 
clearing  of  all,  2- IT 
errors  in.  2-T 
executor.  2-T,  2-13,  2- IT 
nf)de.  2- IT 

oversize  packet  loss,  3-2 
pairs, 
circuit.  2-13 
node,  2-13 
system,  2-8,  2-12,  2- IT 
value, 
nonzero.  2-12 
CSR,  1-2,  2-16,  2-23 
CTS.  2-21 


Data  Link  Mapping, 

See  DLM 
Data. 

conversion  of, 
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Data, 
conversion  of.  (Cont.) 

with  local  modem  loopack.  A-7 

with  remote  modem  loopback.  A-7 
digital, 

in  line/circuit  loopback  tests.  A-7 
integrity  checking.  B-'2 
pattern.  B-2.  B-M 
sink  operations.  B-2 
DDCMP.  2-9.  2-22 
DECnet  test  receiver. 

See  DTK 
DECnet  test  sender. 

See  DTS 
Device  priority. 

See  Priority,  device 
Device. 
commun!cati(m.  2-1.  2-16.  2-22 
connected.  A-7 
DLII.  2-21 
DLU  VVA,  2-21 
DMC/DMR, 

restrictif)ns  for  line  level 

hardware-looped  tests.  A-1 

setting  to  controller  loopback.  2-11 

setting  to  controller  normal.  2-14 
DM  P. 

connecting  to  DMC  device.  2-22 

mode  switch.  2-22 

setting  to  controller  loopback,  2-11 

setting  to  controller  normal,  2-14 
DMR, 

connecting  to  DMC  device.  2-22 
DMV. 

connecting  to  DMC  device.  2-22 

mode  switch.  2-22 

setting  to  controller  loopback.  2-11 

setting  to  controller  normal.  2-14 
Ethernet.  2-17 
half  duplex,  2-9 
hardware. 

loopback,  A-1 
instructions  for  testing  various  types  of. 

2-9 
line. 

connecting  of,  A-7 

testing  of.  A-7 
multipoint,  2-9 
non-Ethernet,  2-17 
QNA. 

instructions  for  testing,  2-9 
remote. 

testing  on  the  Ethernet.  A-1 
switch  settings,  2-22 


Device.  (Cont.) 
UNA. 
instructions  for  testing,  2-9 
testing  of.  A- 12  to  A-  15 
unit  record.  2-25 
verifying  function  of.  A-3 
Digital  Loopback, 

See  DL 
DL,  A-7 
DLM, 
checking  operation  of.  1-4 
testing  with  PSI  checkout  procedure, 

2-9 
verifying  installation  of.  4-4 
DMC  compatibility, 
mode. 
See  Mode.  DMC  compatibility 
DMC/DMR. 
device. 
See  Device,  DMC/DMR 
DMP, 
device. 
See  Device.  DMP 
DMV. 
device. 
See  De\  ce.  DMV 
Driver, 
device.  2-1,  2-9 
terminal, 
X.29,  4-4 
DSR,  2-8 
DTE  address. 

See  Address.  DTE 
DTE  subaddress. 

See  Address,  DTE,  subaddress 
DTE. 
determining/changing  ON/OFF  state  of, 

4-4 
local,  4-1 
remote,  4-1 

role  in  verifying  X.29  terminal  driver 
installation,  4-4 
DTR, 
as  part  of  NTEST.CMD,  2-4 
for  remote  node  software  testing,  2-17 
increasing  buffer  space  for,  B-3 
logical  links  supported  by,  B-3 
on  RSX-US  node,  2-25' 
relation  to  DTS,  B-3 
role  in  Disconnect  tests,  B-2 
role  in  various  Data  Tests,  B-2 
role  in  various  Interrupt  tests,  B-2  to 

B-3 
types  of  tests  provided  by,  B-1 
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DTR,  (Cont.) 
use  of  the  print  option  by.  B-5 
utility  test,  2-19 

DTS. 
as  part  of  NTEST.CMD.  2-4 
buffer  level  opiions.  B-3 
command  format,  B-4 
general  format  for,  2-19 
increasing  buffer  space  for,  B-3 
logical  link  supported  by,  B-3 
restriction  for  RSX-llS  node,  2-25 
role  in  Disconnect  tests,  B-2 
role  in  various  Data  Tests,  B-2 
role  in  various  Interrupt  tests,  B-2  to 

B-3 
test  failure. 
See  Failure.  DTS  test,  for  RSX-llS 
node 
types  of  tests  provided  bv,  B-1 

DTS/DTR,  2-4,  2-19 


EIA. 
asynchronous  communication. 
See  Communication,  asvnchronous. 
EIA 
interface.  A-4 
End  Communications  layer. 

See  Layer.  End  Communications 
Error, 
data, 
inbound.  2-16 
outbound.  2-16 
disk,  2-9 
line.  2-22.  2-23 
Event  logger, 
use  in  problem  isolation,  2-1,  2-22, 

2-23 
verification  of  circuit  state,  2-11 
Event  logging, 
enabling,  2-1 

in  isolating  routing  problems,  3-2 
Event  message, 
See  Message,  event 


F'ailure. 
hardware,  (Cont.) 
common,  2-16 
symptoms,  2-16 
in  testing  SVC  circuits.  4-5 
network  load.  2-8 
NTEST.CMD  procedure, 

common  symptoms  of,  2-8 
of  line/circuit  loopback  test.  A-3 
resource  allocation,  2-8,  2-22.  2-23 
FAL, 
as  part  of  NTEST.CMD,  2-4 
for  remote  node  software  testing,  2-17 
on  RSX-llS  node,  2-25 
File  Access  Listener, 

See  FAL 
File, 
consideration, 
special.  2-20 
NETCFE.CMD, 

See  NETCFE.CMD 
NETCFG.TXT. 

See  NETCFG.TXT 
NETINS.CMD. 

See  NETINS.CMD 
NTEST.CMD. 

See  NTEST.CMD 
RSXMC.MAC. 

See  RSXMC.MAC 
STARTUP.CMD. 

See  STARTUP.CMD 
transfer,  2-4 
FLOW.  B-3 
Full  duplex, 
mode. 
See  Mode,  full  duplex 


Generating  DECnet-RSX, 
Conditions  to  satisfy  before,  1-2 

Group  code. 
UIC. 
network  software,  2-4 


H 


Failure. 
DTS  test, 

for  RSX-llS  node,  2-25 
file  transfer  test, 

for  RSX-llS  node,  2-25 
hardware. 


Half  duplex, 
device. 

See  Device,  half  duplex 
mode. 
See  Mode,  half  duplex 
Hardware, 
communication, 


lnclex-4 


Hardware, 
communication.  (Cont.) 

See  Specific  entry, 
loopback  device. 

See  Device,  hardware,  loopback 
operation, 

verification  of.  1-2 
problems. 

See  Problems,  hardware 
Hung  system.  2-8 


I 


Installation, 
network. 

See  Network,  installation 
of  NCP. 

for  RSX-llS  testing.  2-25 
of  NICE. 

for  RSX-US  testing.  2-25 
testing. 

types  of  tests,  2-1 
Interface, 
communications. 

synchronous.  A-4 
DLll-E.  2-22 
DLll-F.  2-22 
EIA,  A-4 
equipment.  A-7 
node.  2-22 


Large  buffer. 

See  LDB 
Layer. 

Data  Link.  2-9 

End  Communications.  2-1 

Network  Application.  2-1 

Network  Management.  2-1 

Physical  Link.  2-9 

Routing.  2-1.  2-9 

I'ser.  2-1 
LDB.  2-8 
Line. 

baud  rate.  B  6 

corruption  of  data.  2-16 

error. 
See  Error,  line 

ethernet.  1-4 

leased.  1-4 

physical, 
testing  of,  A-4 

private.  1-4 


Line.  (Cont.) 

setting  to  full  duplex  mode,  2-15 

speed  settings,  2-21 

synchronization.  2-22.  2-23 

telephone.  1-2 
Link. 

logical.  2-8 

physical, 
testing  various  aspects  of.  A- 1 
Listener  time. 

See  Time,  listener 
Loopback  connector. 

See  Connector,  loopback 
LSN, 

as  a  substitution  for  NTEST.CMD, 
See  also  TLK.  2-4 


M 


Message, 
data,  B-2.  B-6 
error, 
documenting  test  failures,  2-16 
for  line/circuit  loopback  test,  A-3 
for  SCPXTS. 

See  SCPXTS.  error  messages 
loopback  test.  A- 14 
event, 
confirming  circuit  return  to 

on-starting  state,  2-14 
confirming  connection  to  Ethernet, 

2-23 
confirming  reachable  adjacency,  2-23 
confirming  receipt  of  routing  message. 

3-2 
documenting  problems  with 
passwords.  2-21 
interrupt.  B-3,  B-7 
mulicast.  A-13 
transfer.  2-4 
MIR...,  2-25 
Mirror, 
loopback, 

See  MIR... 
software  loopback,  A-1 
Mode. 
DMC  compatibility.  2-22 
full  duplex.  2-15,  A-7 
half  duplex,  2-15,  A-7 
single  message, 
format  for,  2-20 
Modem. 
Bell  201C,  A-P 
cable. 
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Modem. 

cable,  (Cont.) 
Scv  Cable,  null  modem 

corruption  of  data.  2-16 

eliminator.  A-4 

in  line/circuit  l(K)pback  tests.  A 

l(M)pback. 
analog.  2-15.  A-1.  All 

remote, 
testing  of.  AT 

208A.  A-7 

2()8B.  AT 
Multicast  message. 

Ncc  Message,  multicast 
Multiuser  protection. 

.SVc  Protection,  multiuser 


N 


Name, 
loopback. 

removing  the.  2-14 
node, 
alias.  2-19 
loop.  2-9.  2-12 
remote.  3-1 
NCP. 
correcting  CSR  and  Vector 
specification  with.  2-16 
diabling  a  line  with.  2- In 
enabling  a  line/circuit  with.  2-15 
information  on  commands,  2-1 
performing  line/circuit  kn^pback  test 

with.  A-1 
sending  Ethernet  test  message  with. 

A-13 
service  enabling  Ethernet  circuits  with, 

A-13 
setting  circuit  state  with.  4-5 
setting  Ethernet  circuit  state  with. 

A-13 
setting  up  loop  node  with.  2-25 
testing  for  RSX-IKS  svstems.  2-L  > 
NETCFE.CMD. 

examination  of.  1-3 
NETCFG.TXT. 

examination  of.  1-3.  1-4 
NETGEN. 
commands  entered  and  executed 
during, 
See  NETCFE.CMD 
in  relation  to  N  FEST.CMD.  2-4 
setting  of  segment  buffer  size.  3-4 
Steps  during.  1-2 


NETGEN.  (Cont.) 

Steps  prior  to.  11  to  1   2 
NETINS.(^MI).  2  14 
Network  Application  layer. 

See  Layer.  Network  Application 
Network  Control  IVogram, 

Src  NCF 
Network  File  Transfer. 

Sir  NFT 
Network  Management  layer. 

Sec  Layer.  Network  Management 
Network. 

component  parameters, 
examination  of.  1-3 

configuration, 
at  NETGEN. 

.sVf-  np:tcfg.txt 

examination  of  data  for.  13 
DECnet  RSX. 

interface  with  packet -switching 
network.  1-3 
generation. 

verifying  results  of.  1-4 
installation. 

steps  during.  1-4 

steps  prior  to.  1-3 
management  task. 

See  Task,  management,  network 

lie. 

See  lie,  network 
NFT. 
as  part  of  NTEST.CMD.  2-4 
on  RSX-llS  node.  2-25 
transferring  STARTUP. CMD.  2-19 
NFT/FAL.  2-4.  2  19 
NICE. 

testing  for  RSX-llS  systems,  2-25 
Node, 
address, 
maximum. 
See  Address, 
maximum  node 
adjacent,  2-11,  3-2.  A-12 
assistant.  A-14 
destination.  3-2.  3-3 
executor.  2-11.  2-20 
initialization  process. 

See  Process,  node  initialization 
interface. 

See  Interface,  node 
intermediate.  3-2.  3-3 
loop,  2-25 
loopback.  2-12 
operation. 
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Node, 
operation,  (C'ont.) 

verification  of.  14 
HSX   US.  2  2o 
source.  .'^  2 
VAX. 
determining  large  buffer  size.  H  -4 
NTKST.C^MI). 
procedure, 
alternative  to  loop  node  test.  2  12 
as  a  remote  test.  4  5 
common  symptoms  of  failure.  2  8 
conditions  before  executing.  2  4 

rrection  ot  failures.  2  8 
explanation  of.  2  4 
failures  encountered  during.  2  8 
for  remote  node  sottware  testing. 

2   17 
restriction  for  RSX   IIS  node.  2  2') 
running  the.  2  4 
sample  listing.  2  ">  to  2  7 
Number, 
channel, 
tor  PVCs.  4-4 


Operator, 
remote, 
role  in  remote  testing.  2  1.  2-20.  2-22 
Option, 
buffer  level. 
BIFS. 

Srr  BIFS 
FLOW. 
See  FLOW 


Packet  assembly  disa.ssembly. 

See  X.29  PAD 
Packet  size. 

maximum. 
forPVCs.  4-4 
for  SVCs.  4-5 
Packet. 

loss.  .'^-2.  :^3 
Packet-switching  network, 

See  PSN 
Packetnet  Svstem  Interface. 

See  PvSI 
Paiameter. 

buffer, 
svstem.  2-13 


Parameter.  (Cont.) 
HKLP, 
for  Kthernet  loopback  assistance. 
A   14 
network, 
component. 
See  Network,  component 
parameters 
node. 

for  Flthernet  l(M)pback  test.  A- 14 
physical  address. 

for  Flthernet  loopback  test.  A  14 
usage, 
for  SV('s.  4  4 
Partition. 

system  controlled,  2-4,  2  9 
Password, 
in  Ethernet  testing.  2-23 
problems  with,  2-21 
receive.  2-20,  2-21 
resetting.  2-21 
rules  for  setting.  2-21 
transmit.  2-20.  2-21 
Patches.  1-2 
Path  cost. 

See  Cost,  path 
PCL.  2  9 
PIP.  2-19 
Priority. 

device.  2-16 
Privileged  account. 

.S"('{'  Account,  privileged 
Problem, 
hardware.  2-9.  2-22.  2-23.  A- 15 
in  testing  on  the  Ethernet.  A-15 
isolating,  2-1 
oversized  packet  loss, 
steps  to  correct,  3-3 
PSN, 

in  running  SCPXTS.  4-2 
requiring  Digital  field  service.  2-16 
resource  allocation,  2-8,  2-16 
routing, 

network,  3-1 
software, 

incompatibility,  2-22,  2-23 
testing  on  the  Ethernet,  2-23 
testing  SVC  circuits,  4-5 
Process, 

node  initialization,  2-21 
Protection, 

multiuser,  2-4 
PSI, 
interface  with  DECnet-RSX.  1-3 
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PSI.  (Cont.) 

svstem.  4-1 
PSN. 

DECnet-RSX  network  interface  with. 

facilities. 

DECnet  support  over.  1-4 
svstem  interface  with.  1-1.  1-4 
PVC. 
ensuring  channel  numbers.  4-4 
ensuring  maximum  packet  size.  4-4 
ensuring  maximum  window  size,  4-4 


QNA. 

device. 

See  Device.  QNA 
Qualifier, 
errors. 

receive  overrun,  2-16 


RCP.  2-9 
Re-calls. 

exceeding  maximum  number  of,  4-5 
Request  to  send. 

See  RTS 
Flequest. 

connect.  B-3 
Routing  Control  Process, 

See  RCP 
Routing  layer. 

See  Layer.  Routing 
Routing, 

function, 
overridden  by  loop  node  name,  2-12 

problems. 
See  Problem,  routing 

table. 
See  Table,  routing 
RSX-llS, 

testing  restrictions,  2-25 
RSXMC.MAC,  1-2 
RTS.  2-21 


SCPXTS,  (Cont.) 
steps  before  running,  4-1 
test  procedure, 
explanation  of,  4-2 
SDB,  2-8 
Sequence, 
abort,  B-2 
disconnect,  B-^ 
number.  B-2 
Signal. 
EIA. 
See  also  RTS,  CTS,  2-21 
Small  buffer. 

See  SDB 
Space, 
checkpoint, 
insufficient,  2-9 
STARTUP.CMD,  2-19 
State, 
circuit, 
for  remote  testing.  2-20,  2-22 
Strapping, 

special,  2-15 
SVC. 
checking  usage  parameters,  4-4 
in  running  SCPXTS.  4-1 
verification  of  maximum  packet  size, 

4-5 
verification  of  maximum  window  size, 
4-5 
Switched  virtual  circuit, 

See  SVC 
Symbols, 
verifying  definition  of. 
See  RSXMC.MAC 
SYSGEN, 
specification  of  functions  and  features, 
1-2 
Svstem  pool. 

See  DSR 
System, 
behavior, 
nonreproducable, 
See  Error,  disk 
configuration, 
relation  to  DTS  test,  2-25 


SCPXTS. 
error  messages,  4-2  to  4-3 
format  for  running,  4-2 
number  of  transmits  and  receives,  4-2 
program,  4-1 


Table, 

routing,  3-1.  .3-2 
Task, 

LSN, 
on  RSX-llS  node,  2-25 
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Task,  (Tont.) 
management. 

network.  2-25 
prebuilt. 

.SV^'  also  SCPXTS,  4-1 
TLK. 

on  RSX- lis  node.  2-25 
TDM  address. 

Srv  Address.  TDM 
Test. 
Connect. 

command  format.  B-5 

purpose  ot.  B-1 

types  of,  B-1 
Data. 

command  format,  B-6 

Echo  test.  B--2 

Pattern  test,  B-2 

purpose  of.  B-2 

.Sequence  test.  B-2 

Sink  test.  B-2 

types  of.  B-2 
Disconnect. 

command  format,  B-5 

purpose  of,  B-2 

types  of.  B-2 
Ethernet  loopback, 

description  of,  A-1 

purpose  of.  A- 12 
Interrupt. 

command  format.  B-7 

Echo  test.  B-3 

Pattern  test,  B-3 

purpose  of,  B-2 

Sequence  test.  B-2 

Sink  test.  B-2 

types  of,  B-2  to  B-3 
line  loopback, 

purpose  of,  A-1 

with  a  loopback  connector,  A-3 
loopback, 

line/circuit  level,  A-1 

through  a  loopback  connector,  A-1 

through  a  modem,  A-1 

through  a  remote  node,  A-1 
software  loopback, 

description  of,  A-1 

purpose  of.  A- 12 
Time. 

listener,  2-14 
TLK. 
as  a  substitution  for  NTEST.CMD, 

.SVe  also  LSN.  2-4 
TLK/LSN,  2-20 


Transfer, 
file.  2-4 
message,  2-4 


lie, 

network, 
for  NTEST.CMD.  2-4 
I'NA. 
device. 
See  Device.  UNA 
User  layer. 

See  Laver,  User 
Utilitv, 
CMP, 

See  CMP 
LSN. 

See  LSN 
TLK, 
See  TLK 

V 

Validation. 

content,  B-2 
Vector  address, 

See  Address,  vector 
Vector, 

as  set  in  software  and  hardware,  2-23 

as  specified  during  NETGEN,  2-16 
VNP, 

setting  up  loop  node  with,  2-25 


w 

Window  size, 
maximum, 
for  PVCs,  4-4 
for  SVCs,  4-5 


X 


X.25  Test  Receiver, 

See  XTR 
X.25  Test  Sender, 

See  SCPXTS 
X.29  PAD,  4-4 
X.29  terminal  driver, 

See  Driver,  terminal,  X.29 
XTR, 

program,  4-1,  4-2 
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